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*Right most Hex number will include destination register. 
**Third Hex number will include uppermost bit of shift count (bit 4). 
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INTRODUCTION 



The CONTROL DATA 1704 Computer is a stored program, digital computer. Physically 
small, it is designed for high computation and input/ output (I/O) speed. The program pro- 
tection features of the 1704 Computer and high reliability under a wide range of environmental 
conditions make it suitable for real-time, on-line, or control applications. 

The interface of the 1700 Computer System is capable of accepting a great variety of peripheral 
devices. Refer to Figure 1 for system characteristics. 



Figure 1. 1700 Computer System Characteristics 


Stored program, digital computer 


Reliability (calculated) : 
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1 program protect bit 


Cooling: Forced Air 


16-bit instruction word 


System Interrupt 
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ment) 
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Intercomputer communications: 




1700 to 1700 




Satellite operations 



1.1 MEMORY 

The basic 1700 Computer System provides high-speed, random-access magnetic core 
storage for 4,096 18-bit words. The storage capacity may be expanded from 4K by 4K 
increments to 32K as a maximum. With the addition of special hardware, memory may 
be doubled from 32K to 64K. 



'Registered trademark of Control Data Corporation 
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Storage cycle time is 1.1 microseconds. This is defined as the shortest possible time 
between successive Read/Write operations in storage. 

A storage word may be a 16-bit instruction, a 16-bit operand or a 16-bit address. A 
parity bit and a program protect bit are appended to each 16-bit storage word; thus a 
storage word is 18 bits long. Format: 

17 16 15 Bit 



T ^-Parity Bit ^-16-Bit Data or Instruction Word 

^Program Protect Bit 

Bit 16 is the parity bit. It takes on a value so that the total number of 1 bits is odd (total 
number of bits includes the program protect bit). For example, if all 16 data bits are l's 
and the program protect bit is 0, the parity bit is a 1. 

Bit 17 is the program protect bit. If it is a one, the word is protected and can only be 
modified or changed by a protected instruction. 

1.2 PROTECT SYSTEM 

The program protect system in the 1700 makes it possible to protect a program in the 
computer from any other non-protected program also in the computer. The combination 
of the high internal memory speed and the program protect system makes possible the 
use of the 1700 for background and foreground work. Foreground programs are protected 
and are generally multi-level (level 2 to 15) process programs. The foreground job is 
protected in core and runs at higher priority than background jobs which are assemblies, 
compilations, programs being debugged, etc. The background programs use the time 
available and are run in unprotected core. The protect system is enabled by setting the 
program protect switch on the programmer's panel. Any attempt to violate in any manner 
the protected portion of core from an unprotected instruction will cause a program pro- 
tect violation which sets an interrupt on line and also the program protect indicator 
which is visible as one of the fault lines on the programmer's panel. There are four pro- 
gram protect violations. They are: 

1. An attempt is made by a non-protected instruction to write into a storage location 
containing a protected instruction or operand. It is legal to read from a protected 
area. 

2. An attempt is made to write into a protected storage location by way of the ex- 
ternal storage access when a non-protected instruction was the ultimate source of 
the attempt. 

3. An attempt is made to execute a protected instruction following the execution of a 
non-protected instruction. 
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4. An attempt is made to execute interregister class instructions with bit a one (M 
register is the destination); instructions EIN, UN, EXI, SPB, or CPB. Later ex- 
amination of these instructions will show how these are used to change the state of 
interrupts or the protected core area itself. 

1. 3 INTERRUPT SYSTEM 

The basic computer (1704) provides two interrupt lines. Line provides entry for inter- 
rupts generated as a result of a storage parity error, a program protect fault, or power 
failure. There are instructions available for the processing program to check for parity 
error or protect fault, and power failure can be assumed if one of the other two conditions 
does not exist, hi the case of power failure, approximately 8 milliseconds of program- 
ming time are available; then the computer generates a master clear before the power 
actually goes down. Special hardware is available which can generate an automatic 
restart after the power comes back up. 

Line 1 provides for interrupts from the low-speed peripherals controlled by Equipment #1, 
the slow channel synchronizer. Any of the four stations (TTY, Card Reader, Paper Tape 
Reader, Paper Tape Punch) on the slow channel synchronizer sends its interrupt to line 1. 

The 1705 provides expansion from two interrupt lines to 16 interrupt lines, to provide 
for additional equipment. 

Interrupts are controlled by an interrupt mask register (M Register, 16 bits) which either 
allows selected interrupts in or blocks them out. Each line corresponds to its bit in the 
M Register. If the bit is a 0, any interrupt on that line is blocked out and must wait; if 
the bit is a 1, the interrupt is allowed in. The mask in the M register is set and changed 
under program control. Priority is established by the mask in the M register, not by 
the line position. In the case of concurrent interrupts on more than one line at the same 
priority, the lowest numbered line is recognized first. 

There is a fixed group of core locations assigned to the interrupt system, locations 
$100-$13F, called the Interrupt Trap area. Four core locations are reserved for each 
line, beginning at $100 for line 0; each 4-word block is called the "trap" for that line. 
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Figure 2. 1700 Interrupt Trap Area 
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LINE 1 TRAP 



LINE TRAP 



Contents of Trap: 

word 3- address of interrupt processor 
word 2 - priority level for line 
word 1 - RTJ to interrupt handler 
word - overflow and P 



If the interrupt system is enabled and an interrupt occurs on a line that has a corre- 
sponding 1 in the M register, the hardware does the following: 

1. disables the interrupt system (locks out all interrupts), 

2. saves the contents of the P register (the address of the next instruction which 
would have been executed in the interrupted program) in the first word of the trap 
for that line, 

3. saves the state of the overflow indicator (1 if set, if not set) in bit 15 of that 
same word, 

4. transfers control to the second word in the trap. 

The above is all that the hardware does in handling an interrupt; anything else must be 
done by the software. Under most systems, the second word of the trap for each line is 
initialized by the software to contain a jump out of the trap to a routine (or routines) to 
save the registers of the interrupted program and handle the interrupt. The third and 
fourth words of each trap can be used by the software to contain anything desired; the 
standard operating system uses these words to hold the priority level of the line and the 
address of the processing program for the line, respectively. The interrupt processing 
routine may exit interrupt state (back to the interrupted program) through word of the 
corresponding trap. 

Example : 

Assume line 1 has high priority, line 3 has lower priority. Line always has highest 
priority. Any other running program has lower priority than either line 0, 1, or 3. 
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Make a table containing M register masks to be used while the routine servicing each 
line is running: 



bit 



MASKM 
MASK3 
MASK1 
MASKO 



15 
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mask for main program 
mask for line 3 
mask for line 1 
mask for line 



Note that MASKM will allow all pertinent lines to interrupt; MASK3 will allow line 1 or 
line to interrupt; MASK1 will allow only line to interrupt; MASKO will not allow any 
line to interrupt. 

The processing programs would be set up as follows: 

Main Program 

Set M register to MASKM 

Enable interrupt system 



O 



n 



End 

Interrupt Processor for Line 3 
Store A, Q, I, M registers 
Set M register to MASK3 
Enable interrupt system 

Inhibit interrupts 
Restore registers 
Exit interrupt state 03 

Interrupt Processor for Line 1 
Store A, Q, I, M registers 
Set M register to MASK1 
Enable interrupt system 

Inhibit' interrupts 
Restore registers 
Exit interrupt state 01 
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Interrupt Processor for Line 



Store A, Q, I, M registers ~) could just leave interrupts locked 

out during execution as shown here 



rather than set new mask (mask 
Exit interrupt state 00 J would be MASKO if set and inter- 

rupts enabled) 

Chapter 4 of the Computer Reference Manual contains more details about the Interrupt 
System. 

1.4 INPUT/OUTPUT 

Included with the 1704 is a slow channel synchronizer. This channel handles any or all 
of the slow speed devices normally affixed to a 1704. These are the 1713 Teletype, the 
1729 Card Reader, the 1721 Paper Tape Reader, and the 1723 Paper Tape Punch. * Fig- 
ure 2 shows a data pack extending from these slow speed devices through the slow channel 
synchronizer to both the A and Q registers. Transfer of information to these devices 
then is one word at a time (unbuffered) with the Q register containing address information 
and the A register containing data. The addition of a 1705 to the 1704 extends the A/Q 
unbuffered channel to eight more equipments. The 1705 also provides the addition of a 
direct access bus (DAC) to core. This provides buffered transfer of data directly to or 
from memory, bypassing the registers in the computer and, in fact, bypassing the normal 
compute channel of the computer. This direct access allows high speed transfer of data 
from peripheral devices like discs, drums, mag tapes, or high speed industrial equip- 
ment like multiplexers, etc. 

1. 5 BASIC SYSTEM DESCRIPTION 

Figure 2 illustrates the basic structure of the 1704 and also extension to peripherals 
through the addition of a 1705. The basic 1704 is supplied with 4K (4096 words) of core 
storage. Core can be expanded in 4K increments to a maximum of 32K (or to 64K with 
the addition of special hardware). 

1. 5. 1 Registers 

There are four registers that the programmer can get to directly from instruc- 
tions. These registers are the A, Q, I, and M registers. 

The A Register is the principal arithmetic register. It contains 16 bits (labeled 
bit-0 up to bit- 15) of which bit- 15 is the sign bit for arithmetic operations. The 
A register is also the register used to interface data during input/ output oper- 
ations to peripheral equipment. 



* Also the variations of these (1711, 1713, ,1722, 1724), 
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Figure 3. Basic System Description 
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The Q Register is a multi-use register. Its uses include: 

a. Auxiliary arithmetic register. 

b. Retains part of the result of arithmetic operations such as multiply or divide. 

c. Retains the most significant portion of the dividend during divide operations. 

d. The Q Register is also used as the primary index register for address modi- 
fication. 

e. The Q Register supplies the addressing for peripheral equipments during 
unbuffered input/ output operations. 

The I Register is the second index register available. It is actually core location 
00FF 16 . 

The M Register or Mask Register controls interrupts. A one bit in any position 
of the mask register will enable an interrupt from the corresponding line number 
while a zero in any bit position of the mask register blocks the interrupt from the 
corresponding line number. The mask register is effective in controlling inter- 
rupts only when the interrupt system is enabled. 

Other registers of interest to the programmer are: 

P Register: This 15-bit register functions as the program address counter. It 
holds the address of each instruction, and after executing the instruction at address 
P, P is advanced to the address of the next instruction. The amount by which P 
is advanced is determined by the type of instruction being executed. 

X Register : The X register is an exchange register containing 16 bits. This 
register holds data going to or from memory. It also holds one of the parameters 
in most arithmetic operations. 

Y Register: The Y register is an address register containing 16 bits. It is in this 
register that storage addresses are formed and held for transfer during a storage 
reference. 

The A, Q, M, X, Y and P Registers can be displayed and entered on the program- 
mer's panel. 

Shifter: The shifter is used by multiply, divide, and shift instructions. It is 
capable of shifting the output of the adder left and right one binary position or 
giving a direct transfer path to the arithmetic registers. 

Adder: A 16-bit adder is used to perform all arithmetic and address calculations. 
Inputs to the adder are shown through the gates. The adder is a one's complement 
subtractive adder which is more fully described in the next chapter. 

F Register: This 8-bit register is used by the control section of the 1704 for de- 
coding instructions. 



^ 
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1.5.1 

Z Register; This register communicates between the actual core storage and the 
computer through the X register. Notice this is an 18-bit register; the lower 16 
bits are data or instructions from core, the 17th bit or bit #16 is the parity bit 
and the high order bit or bit #17 is the program protect bit. Core storage is 
described more fully in the next section. 

S Register: This 15-bit register which is fed from the Y register is used to 
directly address core storage. Since core storage has a maximum of 32K loca- 
tions, the S register need only be 15 bits. 

The Z register and the S register are connected directly to external equipment 
through the 1705. This direct access channel allows insertion or extraction of 
core data directly to peripherals without program intervention. 

Refer to Reference 1, Appendix A, for a more detailed description of the reg- 
isters. 
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1.7 CONSOLE DESCRIPTION 
SWITCHES 



Master Clear 



Run/ Step 



Enter/Sweep 



This is a three-position key/lever switch. A Master Clear is 
executed whenever it is momentarily operated either up or down. 
A Master Clear returns the computer and peripheral devices to 
initial conditions by clearing all registers and peripheral equip- 
ment logic. 

This is a three-position key/lever switch. When the switch is 
momentarily placed in theRUNposition, the computer begins pro- 
gram execution, starting with the instruction whose address is in 
the P register. The computer is stopped by momentarily placing 
the switch in the STEP position. 

If the switch is repeatedly placed in the STEP position, the com- 
puter steps through the program, stopping after each storage 
reference. The significance of the storage reference just made 
is indicated by the Instruction Sequence indicators (INSTRUCTION, 
INDIRECT ADDRESS, etc.). 

This is a three-position key/lever switch maintained in all posi- 
tions. The center position is off. Enter is used to enter memory; 
sweep is used to examine the contents of memory. 



^ 



Enter 

The ENTER position selects the Enter mode. In this mode, each 
Step operation of the RUN/STEP switch stores the contents of the 
X register at the location specified by P + 1 and then advances the 
P register by one. The first step after a Master Clear or clear 
P stores the contents of the X register at the location specified 
by P. 

To store a few instructions in unprotected storage, proceed as 
follows : 

1) Power is on but computer is stopped. 

2) Operate Master Clear switch. 

3) Press P REGISTER SELECT switch and CLEAR pushbutton, 
in that order. Set desired address for instruction in P by use 
of indicator pushbuttons. 

4) Set ENTER/ SWEEP switch to ENTER. 

5) Press X REGISTER SELECT switch. 
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Selective Stop 



Selective Skip 



Program Protect/ 
Test Mode 



6) Press CLEAR pushbutton, then enter word to be stored by use 
of indicator pushbuttons. 

7) Move RUN/STEP switch to STEP one time (carefully). 

To store additional words in successive storage locations, repeat 
steps 6 and 7 until finished. To change to a new sequence of 
addresses, start at step 2 for the first one, then repeat steps 6 
and 7 for each successive word. 

A lighted indicator pushbutton indicates a "1", a dark one a "0". 

Sweep 

The SWEEP position selects the Sweep mode. In this mode, each 
operation of the RUN/STEP switch displays in the X register the 
contents of the storage location whose address is P + 1. The P 
register is advanced by one after each Step operation. The first 
step after a Master Clear or clear P displays the location speci- 
fied by P. Instructions are not executed. 

This is a three-position key/lever switch. The computer stops 
when it executes a Selective Stop instruction if this switch is in 
either the up or down position. The up position is maintained; 
the down position is momentary. 

This is a three-position key/lever switch. Two Selective Skip 
instructions (SWS and SWN) are conditioned by this switch. This 
switch is off in the center position; the up position is maintained; 
the down position is momentary. 

This is a three-position key/lever switch maintained in all posi- 
tions. The center position is off. 



Emergency Off 



Program Protect 

The PROGRAM PROTECT position selects program protection. 

Test Mode 

The TEST MODE position selects Test mode. This is used by 
the customer engineers for maintenance. 

Pressing this switch shuts off power for the entire system. 
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Register Select 



The M, P, Y, X, A, and Q registers are available for display and 
manual entry of values via switch/ indicators. A six- pushbutton 
switch/indicator, REGISTER SELECT, selects the register for 
display and entry. 

Push the button for the desired register, and the contents of that 
register will light up in the 16-bit console binary register. A 
button lighted indicates a 1 bit; unlighted, a bit. 

If it is des ired to change the contents of the register, push the 
CLEAR button (not Master Clear switch) to clear out that register. 
Then set the new contents in the register by pushing the button 
(it will light up when pushed) for each bit that should be a 1 bit in 
the register. 



INDICATORS 



Program Protect 



The PROGRAM PROTECT bit indicator displays the state of the 
program protect bit of the last storage location referenced by the 
computer. 



Faults 



There are five fault indicators. When lighted, the fault condition 
is present. 

• HI TEMP The temperature inside the computer has ex- 
ceeded safe operating limits. 

• TEMP WARN The ambient air temperature is approaching 
the maximum safe operating limit. 



OVERFLOW An arithmetic register overflow has occurred. 

PROGRAM PROTECT A violation of the program protect 
system has been detected. 



• STORAGE PARITY A parity error has been detected in an 
operand or instruction read from storage. 

Instruction Sequence When an instruction is being stepped, this group of four indicators 
Indicators describe the meaning of the storage reference just completed. 

The data of the storage reference (read or write) is in the X reg- 
ister. The four indicators and their meaning when lighted are: 

• INSTRUCTION: The contents of theX register is an instruc- 
tion. 
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• INDIRECT ADDRESS: The contents of the X register is the 
result of indirect addressing. The indirect address may also 
be another indirect address, hence, this indicator may re- 
main lighted for several consecutive storage references. 

• STORAGE INDEX: The contents of the X register is the value 
of the Storage Index register. 

• OPERAND: The contents of theX register is the value of the 
operand either written into or read from storage. 

If more than one Instruction Sequence indicator is lighted, the 
computer is running. If only one indicator is lighted, the com- 
puter is not running or is in a rather unlikely program loop which 
does not use operands, the storage index, or indirect addressing. 



o 



o 
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Figure 6. Numbers 
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Decimal 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 



Octal 



1 

2 

3 

4 

5 

6 

7 
10 
11 
12 
13 
14 
15 
16 
17 
20 



Binary 



1 

10 

11 

100 

101 

110 

111 

1000 
1001 
1010 
1011 
1100 
1101 
1110 

1111 

10000 



Hexadecimal 

1 
2 
3 
4 
5 
6 
7 



9 
A 
B 
C 
D 
E 
F 
10 



2. 1 HEX-DEC CONVERSIONS 

Since the 1700 is a 16-bit machine, it is convenient to group the 16 binary bits into 4 
hexadecimal digits. This allows for quicker and easier manipulation of the arithmetic 
and easier identification of program dumps. The relationship of the 4 binary bits to each 
hexadecimal digit and the decimal equivalent is shown below: 



15 14 13 12 


11 10 9 8 


7 6 5 4 


3 2 10 











H. 



H, 



16 Bit 1700 Machine Word 



Hi 



H 
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The Range of Binary Bits in Each HEX Position Is: 
Binary HEX Decimal 



0000 








0001 


1 


1 


0010 


2 


2 


0011 


3 


3 


0100 


4 


4 


0101 


5 


5 


0110 


6 


6 


0111 


7 


7 



Binary 


HEX 


Decimal 


1000 


8 


8 


1001 


9 


9 


1010 


A 


10 


1011 


B 


11 


1100 


C 


12 


1101 


D 


13 


1110 


E 


14 


1111 


F 


15 



This table must be memorized. 

The arithmetic operations that are essentially basic involve binary to HEX, HEX to bi- 
nary, hexadecimal to decimal, decimal to hexadecimal conversion, taking the one's 
complement of a hexadecimal number, and adding and subtracting hexadecimal numbers. 

Each hexadecimal digit represents by its position in the number a certain power of the 
base 16. The least significant digit is a multiple of 16^ which is 1; the second least 
significant digit represents a multiple of 16^ which is 16; the third least significant digit 
represents a multiple of 16^ which is 256; and the most significant hexadecimal digit 
represents a multiple of 16 3 which is 4096. It is necessary then only to do these multi- 
plications followed by a final addition of the four multiples in order to convert a hexa- 
decimal number to the decimal equivalent. 

Example: Convert 13ED^g to Decimal. 

D x 16° = 13 x 1 = 13 
E x 16 1 = 14 x 16 = 224 
3 x 16 2 = 3 x 256 = 768 
1 x 16 3 = 1 x 4096 = 4096 

Sum 5101 10 

There are many methods of converting a decimal number to hexadecimal. The simplest 
method involves successive divisions of the decimal number by 16. Each remainder be- 
comes in turn the least significant hexadecimal digit of the converted answer, while each 
quotient becomes the next decimal number to be divided. Divisions continue until the 
quotient becomes zero. 

Example: Convert 1476 10 to HEX. 

92 - Continue division 
16 I 1476 
144 



36 
32. 
4 - First remainder is Hq=4 



s~ 
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5 - Continue division 
16 l~92~ 
80 
12 - Second remainder is H-j=C 

- Division stops 



16 | 5 

5 - Third remainder is H2=5 

ANSWER - 1476 10 = 5C4 16 

Addition of hexadecimal numbers is straightforward. Notice that 16 is carried from the 
least significant position to the most. The subtracting, of course, is the opposite of ad- 
dition with 16 being borrowed from the most significant position. 

Example: Add the HEX numbers 13CE and 2AA7. 

13CE 

+ 2AA7 



3E75 

n||4 E (14) + 7 = 21 - Carry 16-Excess 5 

C (12) + A(10) +1 = 23 - Carry 16-Excess 7 

3 + A(10) +1 = 14 - No Carry-Excess E 

1 +2 = 3 - No Carry-Excess 3 



As we'll encounter shortly, negative numbers in the 1700 are carried in one's complement 
form. The subtraction in each position of a digit from the largest possible digit in the 
base used yields the one's complement of the number. 

Example: Find the One's Complement of the HEX Number 347E. 

Subtract 

FFFF 

347E 



CB 8 1 - is One's Complement of 347 E. 

The same result can be obtained by converting both numbers to binary. 

HEX BINARY 

FFFF = 1111 1111 1111 1111 

34 7 E= 0011 0100 0111 1110* 



CB81= 1100 1011 1000 0001 is One's Complement of 

Notice that the one's complement of a binary number has all ones in the binary number 
changed to zeroes, and all zeroes changed to ones, which suggests another method of 
obtaining the one's complement of a number. 
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Figure 7. 1700 Integer Numbers 



/ 



Example: 













□: : 




1 
1 




t 

SIGN 

1 


BIT 






3B7 16 = 


=0000001 


110110111 


IV 


W" 


3 


B 


A / 

7 



Negative Numbers Stored in One's Complement Form: 



r~ 



-3B7 16 = 



F 
3 



F 
B 



F 
7 



8 



/- A -v 



_A_ 



A 



11111 1000 100 1000 



SIGN BIT 
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2. 2 RANGE OF NUMBERS 



Figure 8 illustrates the range of numbers used in the 1700. The total number of bits 
available is 16 and for arithmetic operations bit #15 will be a zero for positive numbers, 
and a one for negative numbers. For positive numbers, bits 0-14 are in true form. How- 
ever, for negative numbers bits 0-14 are in one's complement form. Notice there are 
two 0's, a positive zero and a negative zero. 



Positive Numbers-Bit 15 is a - Number is in true form. 



o 





1 


-fOS 


mve i 


NumDers- 


+32,767 


0111 


1111 


1111 


mi 


+32,766 


0111 


1111 


1111 


1110 


I 


• 


• 


• 


• 


Positive 


• 


• 


• 


• 


Numbers 


• 


• 


• 


• 


I 


• 


• 


• 


• 


+1 


0000 


0000 


0000 


0001 


+0 


0000 


0000 


0000 


0000 


-0 


1111 


1111 


1111 


1111 


-1 


1111 


1111 


mi 


1110 


J 


' • 


• 


• 


• 


Negative 


• 


• 


• 


• 


Numbers 

t 


• 


• 


• 


• 


• 


• 


• 


• 


-32,766 


1000 


0000 


0000 


0001 


-32,767 


1000 

t 


0000 


0000 


0000 



Negative Numbers-Bit 15 is a 1 - Number is in One's 

Complement Form. 



Note: Each Negative Number is Represented as the One's Complement of its 
Corresponding Positive Number. 

Figure 8. Range of Numbers Used in the 1700 f 
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2.3 ADDER 



A straightforward adder would pose problems in the 1700 in that negative zero in many 
cases would be produced as a result instead of a positive zero. Consider the addition: 

4321 
+ BCDE 



FFFF - Straightforward addition of the positive number 4321 and a negative num- 
ber of the same size, BCDE, yields a correct result of zero, but nega- 
tive zero instead of positive zero. 

Since the skip tests do not recognize negative zero, the adder in the 1700, which is a 
16-bit one's complement subtractive adder, eliminates minus zero in all but one case. It 
functions by taking the one's complement of the addend and subtracting this from the 
augend. The same addition as in the above is accomplished: 

Add 

4 321 4321 4321 

+ BCDE ►One's Complement— » »4321- ►Now Subtract 4321 

Same Result »* 0000 

But +0 

The one case where a minus zero is produced is the case where minus zero is added to 
minus zero. 



Add 


Subtract 


FFFF 


FFFF 


+ FFFF 


► OOOO 



FFFF (-0) + (-0) = (-0) 

Negative zero can be converted to positive zero by simply adding positive zero to it. 

Add Subtract 

FFFF FFFF 

+ 0000 ►FFFF 



0000 (-0) + (+0) = (+0) 

For subtraction, the subtrahend is not complemented, but is subtracted directly from the 
minuend. The only case producing negative zero is (-0) - (+0) = (-0). 

Subtract Directly 

FFFF 
0000 



FFFF 



Page 3-20 of Reference 1, Appendix A, expounds further on conditions causing negative 
zero. 
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2.4 OVERFLOW 



Overflow in the 1700 is essentially a condition wherein the result of some arithmetic 
operation is too large to fit into its designated register. Overflow can be caused by add 
type operations, by a subtract type operation and by divide, hi a one's complement com- 
puter like the 1700, overflow, when it occurs, sets the overflow indicator which remains 
on until tested. Refer to Figure 8. Notice that overflow will not occur when a positive 
number is added to a negative number since the result will always lie within the range of 
numbers. Adding two positive numbers together or adding two negative numbers together, 
or the equivalent operation (subtracting a negative number from a positive number or 
subtracting a positive number from a negative number), can cause a result which is too 
large to be contained in the A or Q Register. Recovery can be made from add type over- 
flow operations and, in fact, overflow is often a useful tool for accumulating single pre- 
cision numbers into double precision numbers. 

Example: Add 1 to the Largest Possible Number 

7FFF 

0001 ^Complement 7FFF Note: If the adder must borrow from 

Then Subtract -» »FFFE beyond the most significant 

t 8 01 position, it subtracts 1 from 

Subtract Borrow ' 1 the result. 

8 — ^Answer is now (-7FFF) which is wrong. 

The computer logic will set the overflow indicator when both signs are initially the same 
and a borrow occurs. 

Recovery can be made, however, by accumulating the overflow in a second cell and 
masking out bit- 15 of the first, since bits through 14 remain correct. 

Remember that any add type instruction can cause overflow. This includes ADD, SUB, 
RAO, AAQ, etc. 

Divide overflow will be described in more detail in the storage reference class of instruc- 
tions for the DVI instruction itself. 

2.5 FLOATING POINT NUMBERS 

Floatingpoint numbers will be of interest to scientific programmers, and since the 
Fortran compiler provides for them, their format will be discussed here. The range is 
.591 x 10 -39 through 1.694 x 10 39 . 

Floating point numbers require two words of core and include: one bit, sign of coeffi- 
cient; 8 bits, biased exponent; 23 bits, normalized coefficient. 
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Word 1 




Word 2 






A 

7 






A 




/l5 .14 


6 


oVl5 




(A 


a 


\ 


-v A 

Exponent 


1 
1 
1 


v 

Coefficient 


/ 




8 Bits 




23 Bits 




Sign of Coefficient 








1 Bit 













A number, for example 25. , would be packed as follows: 

1. convert decimal number to hexadecimal 

25 *10 = 19 -i6 

2. convert hexadecimal number to binary 

19. 16 = 0001 1001. 2 

3. normalize the binary number (move the binary point to the left of the first one bit) 

0001 1001. 9 = ,11001 9 x 2 5 w 

2 / 2 \ 

coefficient exponent 

(power of 2) 

4. bias the exponent. In the 1700, all exponents (positive or negative) are biased by 
80i6 (80 is added to the exponent) 

2 5 = 5 + 80 = 85i 6 

5. pack the number in the two words: 






10000101 


1100100! oooooooooooooooo 



expo-] 



->\_ 



onent 

85 



V 
Coefficient 
Left Justified 



sign of coefficient 

= 42E40000 16 

A negative number would be packed as though it was positive, then both words 
would be complemented. 

-19 16 = 



1 


01111010 


0011011 ', 1111111111111111 



= BD1BFFFF 



16 



To unpack numbers (i. e. , from a HEX dump) the reverse procedure is followed. 
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Figure 9. Floating Point Example 



EXAMPLE: PACK 375 10 



375 10 = 177 



16 



177, e = 0001 0111 0111 



16 /375 

Z23_r 7 

Or 1 



16 



. 1011 1011 1000 x 2 9 



4 







7 



9 
+ 80__ 

8916 
EXPONENT: 10001001 2 



-375 10 WOULD BE STORED AS 



F 
- 4 



F 
4 



F 
D 



F 
D 



F 
C 



F 




F 




F 




B B 



2 



16 



E [piiiqijqJbiooqj^]bo ij ij 11J.1J11JI1_ 
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2.6 EXERCISES 

1. Group these 16 bit 1700 binary numbers into hexadecimal, convert the answers to 
decimal, then add the three together. 

a. 0010 1101 1010 1110 

b. 1000 1111 1100 0111 

c. 1111 1111 1100 0000 

2. Convert these decimal numbers to HEX, and represent each in binary as they would 
appear as a 16-bit 1700 word. 

a. 4095 

b. -17 

c. 255 

3. How would a signed number, either positive or negative, that occupied only an 8-bit 
field be expanded to occupy a 16-bit field? 



r 
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3. 1 PROGRAM FLOW 



Two phases are involved in processing the assembly language program. The first phase 
involves reading of the source program (the program prepared by the programmer) into 
the computer under control of the assembler program. The assembler program reads 
and decodes the instructions outputting a listing with the object program. The object 
program, which can be output on either paper tape, mag tape, or disk is in a formatted 
form suitable for loading back into the computer under control of the relocating linking 
loader program. This re-entry of the object program into the computer through the loader 
is Phase Two. After loading, relocating and linking this program appropriately to other 
programs, the program can now be executed. Two large standard software packages, 
then, are involved in the assembly process; the assembler itself and the relocating linking 
loader. Figure 10 illustrates this diagrammatically. 



Phase 1 - Assembly of Source Program 



Source Program 




o 



1700 Computer 



Assembler 
Program 



or 



1/V 

Paper Tape 



Object Program 



Paper Tape 




Mag Tape 



Disk k A 

Listing on typewriter 
or printer 



Phase 2 - Loading and Running of Object Program 



Object Program 



r W 



1700 Computer 



Relocating 
Linking Loader 



Results 



Figure 10. Processing the Assembly Language Program 
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3.2 1700 ASSEMBLY LANGUAGE SOURCE FORMAT 

Regardless of the standard assembler being used (utility assembler or macro assembler) 
the source format is prepared the same. This source format consists of four fields, the 
location field, the opcode field, the address field and the comment field as illustrated 
below: 



Location 



Opcode 



Address 



Comments 



The total width of all four fields combined is 72 columns. Each field, however, can be of 
any length and the statements are said to be free-field. To signal the end of these fields, 
either a blank or a tab is used. The blank is technically used as the field terminator for 
card input source with consecutive blanks ignored and the first non-blank character 
signifying the beginning of the next field. For paper tape input source the tabular key 
depression is normally the field terminator since the source can be typed using tab fields 
to arrange the source type in an orderly fashion. Blanks, however, can be used for paper 
tape input source as field terminators also. Consecutive tabs will indicate the absence of 
a field. The carriage return key depression will signify the end of a statement for paper 
tape input source. The end of the card itself for card input source is the statement ter- 
minator. 



3. 2. 1 Location Field 

The location field is used for placing symbols which will define positions in the 
program. These symbols have a maximum length of six characters (more than 
six will not be processed by the assembler) and the first character must be alpha- 
betic. 



Example: 

Location 

A123 
1A23 

TAGTOMB 



Opcode 



Address 



Comments 



Legal 



-»- Illegal - must begin with 

alphabetic 
-*■ Legal - only TAGTOM is 

processed. 



The same symbol cannot be used twice in the same program, as this would con- 
stitute a doubly defined symbol, an error condition. Upon finding a symbol in the 
location field, the assembler places this symbol with its location in its internal 
symbol dictionary. Further references to this symbol then will yield its location. 

An asterisk in the first column of the location field indicates that all subsequent 
information in that statement is to be treated as a remark. 
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Example: 
Location 



Opcode 



Address 



Comments 



* THESE LINES WILL BE PROCESSED AS A REMARK AND 

* APPEAR ONLY ON THE LISTING. THEY DO NOT GENERATE 

* ANY MACHINE CODE. 

START 

Symbols appearing in the location field corresponding to certain pseudo instruc- 
tions are meaningless. These will be discussed under the section dealing with the 
pseudo instructions. A numeric entry into the location field is allowed for one 
pseudo instruction only, the NAM pseudo instruction. 



3. 2. 2 Opcode Field 



In this field, machine instruction mnemonics or pseudo instructions or macro 
names (if the macro assembler is used) are placed. The machine mnemonics will 
be decoded by the assembler with the appropriate machine codes generated. The 
pseudo instruction will produce action by the assembler and may not, for some 
pseudo instructions, generate any specific machine instructions. Macro names 
will be discussed in Chapter VII. 



Example: 
Location 



Opcode 



Address 





NAM 
i 


START 

1 
1 


1 
1 

^DA 

J 
i 


1 
J 


i 
\ 


Address Field 





Comments 

NAM is a pseudo- 
instruction 

LDA is a machine 
mnemonic 



The operands used in the address field are: 

Symbolic 

Numeric 

Asterisk 

Special Characters (A, Q, M, 0, 1, B) 

Combination of above special characters joined by arithmetic 

operators (address expression) 
Null (absence of operand) 

Symbols used in the address field either alone or in an expression, must be legally 
defined. Besides appearing in the location field, symbols can be defined as being 
names in the address field of certain pseudo instructions. 
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Numeric operands in the address field can be either decimal or hexadecimal. To 
distinguish between the two, a $ sign would precede the hexadecimal number (1234 
is a decimal, $1234 would be hexadecimal). The range of decimal numbers must 
be + 32,767. The range for hexadecimal numbers is +_7FFF. Expressions are 
formed by the combination of either symbolic or numeric operands with addition, 
subtraction, multiplication or division operators (+, -, *, /). Nesting is not 
allowed. The expression is scanned left to right with divisions and multiplications 
done first and a second scan left to right for addition or subtraction. An expres- 
sion evaluated as a constant in the address field may be used only with the =X 
form of constant, not =N. 



Example: 

Location 

I 
TAG1 

I 
TAG2 



Opcode 



LDA 



Address 



TAGl+6*$lC/4 



Comments 



If TAG1 is at location 10 3 ^g, the expression is evaluated: 

1st) 6 x 28 = 168 
2nd) 168 £ 4 = 42 = $2A 

3rd) 0103 + 2A = 012D, then the contents of core location 012Di 6 is loaded into 
the A register at run time. 

The asterisk can be used in the address field to also specify the current location 
of the program counter when the instruction is assembled. If the instruction is 
two words long, the asterisk specifies the first word of the instruction. Even 
though the asterisk is also used in the address field as a multiplication sign, the 
logical use of the asterisk for both processes will not conflict. 



Example: 

Location 

I 
TAG 

I 
I 



Opcode 

I 
LpA 

I 

I 

I 

LDA 



Address Comments 

I 
*-2 Will load A with contents 

I of the core location 2 be- 

! fore TAG. 

TAG1 LDA **2 The first * refers to the 

location of TAG1, the 
second * is for multipli- 
cation. 

The special symbols Q, I and B are used with the storage reference instructions 
to refer to index registers. Q refers to Q register index modification, I refers 
to the contents of location FF to be used as an index register, and B would specify 
both the Q register and location FF to be added to the base ( address to form the 
effective address. 



'~~N 
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Example: 
Location 



Opcode 

I 
LDA 



Address 

I 
TAG, I 



LDA 



LDA 



TAG,Q 

I 

I 
TAG,B 



Comments 

The contents of core lo- 
c at ion FF are added to 
TAG to produce the ef- 
fective address. 

Same as above, but Q 
register is used. 

Both Q and I are added. 



The address field for any of the interregister instructions requires either A, Q 
or M registers as a destination. 



Example: 
Location 



Opcode 

I 
AAQ 



TRA 



Address 

I 
A,Q 

I 

I 

I 
A,Q,M 



Comments 

Add A to Q and put re- 
sults in A and Q 

Transfer A to A, Q and 
M registers 



For the interregister instructions, A, Qand M, refer to the registers A, Q and M. 
3.2.4 Comment Field 



This field is used for remarks that are printed as part of the list output. Entries 
in this field do not produce any machine code. 

If it is desired to put a comment on an instruction which does not have an address 
field (i. e. , SLS) it is advisable to put a in the address field, before the comment 
begins, to eliminate an assembly error message. 



i.e. 



SLS 
SLS 



COMMENT 
COMMENT 



incorrect 
correct 



3. 3 ASSEMBLY LISTING 

The assembly list consists of 18 columns of descriptive information related to the source 
statement, followed by a maximum of 80 columns listing the source statement. 



n 
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Column Contents 

1-4 line number; truncated to 4 decimal 

digits 

5 space 

6 relocation designator for location 

P program relocation 
D data relocation 

7-10 location in hexadecimal 

11 space 

12-15 machine word in hexadecimal 

16-17 relocation designator for word 

P program relocation 

-P negative program relocation 

C common relocation 

-C negative common relocation 

D data relocation 

-D negative data relocation 

X external 

blank absolute 

18 space 

19-98 input source statement 

SYMBOL TABLE A table containing the location symbols, locations, and relocation 
values is printed at the end of pass 3 if the L option is selected. For- 
mat of the symbol table: 



Column 


Contents 


1-6 


symbol name 


9-12 


location 


13 


relocation of location 


15-20 


symbol name 


23-26 


location 


27 


relocation of location 


29-34 


symbol name 


37-40 


location 


41 


relocation of location 



The columns not specified above contain spaces. 
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Figure 11. Sample Assembly Listing 



Line Number 



0001 
0002 
0003 
0004 

0005 
0006 

0007 
0008 




P0000 
P000 1 
P0002 
P0003 
P0004 
P0005 
P0006 



0000 

C400 

0006 

60FF 

1400 

8000 

0010 



START 



OOFF START 



— Number of errors 
would appear here 



Location (relative to beginning of program) 



Contents of Location (hexadecimal code 

of instruction) 

SOURCE 

START 



X 



NAM 
ENT 

LDA + 



STA- 
JMP + 

NUM 
END 



(START) 



S10 
START 



J 



t 

Input Source Statements 



0000P X 



0006P 



Symbol Table 



Appendix D contains error messages. 
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CHAPTER IV - Basic 1700 Instruction Familiarization 

TOPIC PAGE 

4.1 LDA, STA, ADD Assuming Data Available 4-1 

4.2 LDA, STA, ADD Using Preset Data 4-1 

4. 3 LDA, STA, ADD Using Preset Data to 4-2 

Illustrate Looping 

4.4 STQ and MUI Instructions 4-2 

4.5 LDQ and D VI Instructions 4-3 

4.6 JMP and RTJ to Illustrate a Subroutine 4-3 



O 



4.1 



4. 1 LDA, STA, ADD ASSUMING DATA AVAILABLE 

The Load A (LDA) instruction replaces the contents of the A Register with the contents of 
the referenced memory location. The contents of the memory location is not changed. 

The Store A (STA) instruction replaces the contents of a referenced memory location with 
the contents of the A Register. The contents of the A Register is not changed. 

The Add to A (ADD) instruction forms a 16-bit sum of the contents of the A Register and 
the contents of the referenced memory location and places this sum in the A Register. 
The contents of the memory location is not changed. 

Problem: Replace the contents of location SAVE with the sum of the contents 
of locations SAVE and DATA, assuming that both locations con- 
tain legal data. 



Location 



Opcode 

LDA 

ADD 

STA 



Address 
DATA 
SAVE 
SAVE 



4.2 LDA, STA, ADD USING PRESET DATA 

The NUM instruction creates a table of constants listed in the address field behind the 
instruction. If a Label is given, it is assigned to the first value. 

The BSS pseudo instruction reserves a segment of core to be used for any purpose. The 
data contained is unknown at load time. 

The BZS pseudo instruction reserves a segment of core to be used for any purpose and 
fills this area of core with all zeroes. 

Problem: Add zero to the contents of location TAG and store the result in 
location TAG2. Locations TAG and TAG2 should then be equal. 

Location Opcode Address 

TAG 



NUM 


$423 


BZS 


TAG1(1) 


BSS 


TAG2(1) 



BEGIN 



LDA 


TAG 


ADD 


TAG1 


STA 


TAG2 
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4.3 LDA, STA, ADD USING PRESET DATA TO ILLUSTRATE LOOPING 

The Skip if A is Zero (SAZ) instruction checks the contents of the A register. If A is all 
zeros, the program skips to a prestated location up to 16 locations forward, (never back- 
ward). If not, program control goes to P + 1 (the next location). 

The Skip if A is Positive (SAP) instruction checks the uppermost bit of the A register. If 
this bit is "0" (positive), program execution will skip to the specified location up to 16 
locations forward, (never backward). If not, the program will continue at P + 1. 

The Skip if A is Minus (SAM) operates identically to the SAP instruction except that the 
uppermost bit of the A Register is checked for a "1", indicating a negative quantity. 

Problem: Add 21-^g to each of the quantities in array TAG1 and then store 
these new numbers at array TAG2. 

Index Register I will be used for controlling the loop. It starts at 4 and progresses 
through 3, 2, 1, 0, then the loop ends when it turns negative. 



Solution: 
Location 
TAG1 



TAG3 
ONE 

SAVE 



Opcode 

NUM 
NUM 
BSS 

NUM 
NUM 
NUM 



Address 

$4152, $0431, $0210 

$12F3,$F201 

TAG2(5) 

$21 

$0001 

$0004 



Comments 



BEGIN 



LOOP 



DONE 



LDA 

STA 

LDA 

ADD 

STA 

LDA 

SUB 

STA 

SAZ 

JMP 

SLS 

END 



SAVE 

$FF 

TAG3 

TAG1, 1 

TAG2, 1 

$FF 

ONE 

$FF 

DONE-*-l 

LOOP 





4-^-FF for loop control 

1st no. *- A 

(A)+(TAG1 +(FF)) ► A 

(A) ► TAG2+(FF) 

Subtracts 1 from A 

Skip to DONE if (A) = 

Stop Instruction 



4.4 STQ AND MUI INSTRUCTIONS 

The Store Q (STQ) instruction replaces the contents of the referenced memory location 
with the contents of the Q Register. The contents of Q are unchanged. 
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O 



The Multiply (MUI) instruction forms a 32-bit product of the contents of A (multiplier) 
and the contents of the referenced memory location (multiplicand) and places the product 
in the QA Registers. The contents of the memory location is not changed. 



Problem: 



Location 



Multiply the contents of MEM by the quantity 20^g which is currently 
in A. Store the results of A in memory location A and the results 
of Q at memory location Q. 



Opcode 

MUI 
STA 
STQ 



Address 

MEM 

A 

Q 



Comments 



4. 5 LDQ AND DVI INSTRUCTIONS 

The Load Q (LDQ) instruction places the contents of the referenced memory location into 
the Q register. Contents of memory are unchanged. 

The Divide Integer (DVI) instruction divides the 32-bit QA Register by the contents of the 
referenced memory location. The contents of memory are not changed. Q will contain 
the remainder and A the quotient. 

Problem: Divide 4528- R by the contents of location SAVE 



Solution: 








Location 


Opcode 


Address 




SAVE 


NUM 


$0025 


Divisor 


TAG1 


NUM 


$4528 


Dividend 


TAG2 


NUM 


$0000 






LDQ 


TAG2 


Clear Q 




LDA 


TAG1 


Get dividend 




DVI 


SAVE 


Answer is in A 



4. 6 JMP AND RTJ TO ILLUSTRATE A SUBROUTINE 

The Jump (JMP) instruction causes a program sequence to terminate and initiates a new 
sequence at a specified location. 

The Return Jump (RTJ) instruction is a jump enabling the program to begin execution in 
a new location and, by storing a return address, return to the next instruction in the 
program sequence. 

Problem: During the main program sequence, skip to a routine to clear a 
storage area, and return to the location which the program left. 



r 
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Location 


Opcode 


Address 


Comments 




LDA 


NAME 






STQ 


SAVE 






RTJ 

1 
1 


CLEAR 


Leaves P+2 in CLEAR. 
Program Control given 
to LDA TAGY. 




SLS 






CLEAR 








Return address placed 




LDA 


TAGY 


here. 




STA 

i 
i 


TAG2 


Clear location(s) 




1 

JMP 

1 

1 


(CLEAR) 


Will return control to the 
SLS instruction. 


TAGY 


1 
NUM 







TAG2 


BSS 


TAG2(1) 
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5.1 



INTRODUCTION 

There are five classes of instructions in the 1700. They are: 

Shift Class Instructions 

Skip Class Instructions 

Storage Reference Class 

Register Reference Class Instructions 

hiterregister Class Instruction 

Only the storage reference class uses core for operands. Instructions in all classes other 
than storage reference class are one word instructions and take 1. 1 microseconds to execute 
with the exception of the shift class instructions whose execution time depends on the number 
of bits shifted, and INP and OUT instructions. Refer to Appendix B for instruction execution 
times, or to section 5. 1. 3. 

5. 1 STORAGE REFERENCE CLASS 

Of the five classes of instructions in the 1700, only this group uses core for operands. 
This means, then, that the instructions in this group are the only ones that are address- 
able. Because of the limitation of 16 bits in an instruction word to implement the ability 
to reach any core location from any other core location, two-word instructions are used. 
One- word instructions are available for addressing either absolute core blocks or within 
a fixed range of core locations from the instruction. The format for these instructions is: 



Address Mode 
^ 



15 



12 11 10 9 



first word: 



F 


r 


ind 


q 


i 


A 



% v ' 11 k k K 

Instruction a li 



Relative 
Address Flag — 

Indirect Address Flag 
(ind. ) 



TJeita" 



Index Register Flag 



Q 



Index Register Flag 



second word: 



M 



n 



A is not zero for one- word instructions. 

A is zero, and M contains the operand (or operand address) for two-word instructions. 

The instructions are defined by the F field and will be discussed later. The rest of the 
format word deals with various ways of addressing the instruction; this will be discussed 
first. 
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Figure 12. Address Modes for Storage Reference Class Instructions 



ADDRESS MODE 



first word: 



15 




12 


11 


10 


9 


8 


7 







F 


r 


ind 


q 


i 


A 



Instruction 
Relative 
Address Flag 
Indirect Address Flag- 
find) 



J 1 



Delta r 

■ I Index Register Flag 
Q Index Register Flag 



A/0 for one-word instructions 
A = for two-word instructions 



second word: 



Name 



Constant 



M 



Assembly Language 

t Designator , 

Opcode Address Operand Hex 



C000 
0203 



C000 
2000 



C000 
4142 



Example 



Terminator Field 



Address Code- 



Instruction 



Comments 



P+l 



** LDA =N$203 

*** LDA =XBUF 

**** LDA =AAB 



Numeric constant $203 *" 

Address of BUF — »► A 
ASCII codes for AB *-A 



One- Word Absolute 
One- Word Abs. Ind. 

Two- Word Absolute 
Two-Word Abs. Ind. 



( ) 



( ) 



A 
(A) 

M 
(M) 



C0FF LDA- $FF 
C4FF LDA- ($FF) 



Contents of location $FF 



C400 
0106 
C400 
8106 



LDA+ $106 
LDA+ ($106) 



Loc $FF contains address of operand; operand 
is loaded into A 

Contents of location $106 *-A 



Loc $106 contains address of operand; operand 
is loaded into A 



One- Word Relative 
One- Word Rel. Ind. 

Two- Word Relative 
Two- Word Rel. Ind. 



P+ A C845* LDA* BUF 

( ) (P+A) CC45 LDA* (BUFADR) 



C800 
P+l+M nnAA LDA BUF 
0044 

ccoo 

( ) (P+l+M) Q044 LDA (BUFADR) 



Contents of loc BUF— *-A; BUF is within 127io 
Iocs of the LDA instr. 

Loc BUFADR contains addr of operand; operand 
in BUF — »-A; BUFADR is withi n 127 1Q locs of 
LDA instr. 

Contents of loc BUF — *-A; BUF is any distance 
from the LDA instr. 

Loc BUFADR contains addr of operand; operand 

*-A; BUFADR is any distance from the LDA 

instr. 



*If the buffer is 45^6 locations in the positive direction from this instruction 
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5. 1. 1 Addressing for Storage Reference Class Instructions 

Figure 12 illustrates the various ways of addressing storage reference class in- 
structions. The combination of the r, hid, and A bits determines the mode of 
addressing used. Because of the limitation of 16 bits in an instruction word, some 
modes of addressing require two words to reach all parts of core. A brief glance 
at this chart shows a direct correspondence between two- word instructions and the 
bit content of A. When A (bits 0-7) in the instruction word is all 0's, two con- 
secutive core words are used as a single instruction. Also, there are only three 
main types of addressing: constant, absolute and relative. Within the absolute 
and relative types are one and two-word varieties and also one and two-word 
indirect types. Listed also in this table are the proper assembly language desig- 
nators necessary to tell the assembler the exact mode of addressing desired. In- 
direct addressing is specified by parentheses enclosing the address field contents. 
This table ignores manipulations with the index register since index register 
modification is common to all modes of addressing. This figure gives only the 
base address for each mode. The base address must be found before index register 
modification occurs even when indirect addressing is specified. In each of the 
indirect addressing modes notice that the base address is specified as the contents 
(the use of parentheses around the address specifies the contents of) of its corres- 
ponding non- indirect mode. This means that for indirect addressing a further 
search is made into the addressed core location to find the base address. 

5. 1. 1. 1 Constant Mode 



This mode of addressing is used where an operand is known to the programmer, 
that is, he is using a constant. This mode of addressing utilizes two words. 

The first word of the instruction is specifically the instruction itself, the mode of 
addressing for this example is constant, and the unused bits in this word will be 
set to zero. This arrangement is illustrated below: 



15 






— +. Bit -* 
















- 


F 





q I 



























Instruction ♦ 4 * — lnd=0 * — A =00 

LR=0 



r~ 



The upper four bits signify the actual instruction. This field is called the F field. 
The next four bits, that is, bits 8, 9, 10 and 11, are used to signify the mode of 
addressing for the instruction. Also, bits 8 and 9 will s ignify indexing, where 
bit 8 signifies index register I which is core location FF, and bit 9 will indicate 
indexing with the Q register. For the constant mode of addressing bit 10, which 
is called the indirect bit, is a zero and bit 11, which is called the relative bit, is 
also a zero. For our example here, we will assume no indexing used, therefore 
bits 8 and 9 will be 0. The lower eight bits, that is bits 0-7, are called the A 
field, and for constant mode of addressing all these bits are 0's. 
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The combination of the A field, the indirect bit and the relative bit are indicators 
to the machine of the mode of addressing used. Note for constant mode the field 
is all O's, the indirect bit is a and the relative bit is a 0, signifying constant 
mode of addressing. 

Numeric constants . This form is for numbers. 

Example: 

LDA =N$407F 

This c ons tant mode instruction written in assembly language will generate two 
machine words of code: 

at P C000 

P+l 407 F 

The operand itself is placed in the second word, so the base address is P+l, the 
second word of the instruction. 

The =N in the address field signifies to the assembler the constant as numeric (a 
number). The number can be either decimal or hexadecimal (in which case it is 
preceded by the dollar sign). The result of the above example is to load into A 
the number 407 F^g* 

Example: 

LDA =N256 

The decimal number 256 would be converted and the following code generated: 



at P 


COOO 


P+l 


0100 


Illegal example: 




LDA 


=N$100+$27 



An error message would result because address arithmetic (+) is not allowed with 
the =N form of constant addressing. 

Address constants . This form is for 15-bit addresses and address arithmetic on 
numbers. 

Example: 

LDA =XTAG 

The =X in the address field signifies that TAG is a symbol. The assembler sub- 
stitutes the value in its symbol directory for the symbol and puts this value in 
P+l. If, for example, TAG is a location symbol at address 100 in the program, 
the following code is generated. 
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/ — • ■ '"" 

'^ at P COOO 

^ P+l OlOO 

An expression can also be used: 

LDA =XTAG+10 

This will put the address of TAG+10 in the code: 

at P COOO 

P+l 010A 

The =X form of address constants is the correct way to allow numeric address 
arithmetic: 

ADD =X$34F2-022+$lA 

will generate code to add to the contents of the A register 34F6^g. 

P+l 34F6 

Even though the result of the expression in the address field is a constant, the =X 
form must be used rather than =N because an expression is not allowed with =N. 
LDA =X$100+$27 would be legal and would generate: 

at P COOO 

(") P+l 0127 

In address expressions only a 15-bit constant will be produced so note that 

LDA =X-TAG 



r 



will generate 






at P 


COOO 




P+l 


7EFF 


(not FEFF) 


also, with numbers: 






LDA 


=X-11 




will generate 






at P 


COOO 




P+l 


7FF4 





This feature of the assembler can well be utilized in sophisticated coding. 
ASCII constants. This form is for alphabetic and numeric characters. 
Example: 

LDA =AXY 
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The =A means that the alphanumerics following (only 2 allowed) are to be converted 
to their ASCII 8-bit code. (See Appendix E. ) The first alphanumeric (X in this 
case) ASCII code is placed in the high order 8 bits of P+l, and the second ASCII 
equivalent is placed in the lower 8 bits. The code will be: 



at P 
P+l 



COOO 
5859 



A blank is a character in the ASCII form: 



LDA 

will generate the code: 

at P 
P+l 



=A X 



COOO 
2058 



ASCII will be discussed in detail when I/O is discussed. 



.es: 








COOO 
1000 


LDA 


=N$1000 


Get 1000^g into A register 


COOO 
00C8 


LDA 


=N200 


Get 200^0 into A register 


COOO 
0500 


LDA 


=XDATA 


Get address of DATA P0500 
into A register 


COOO 
0505 


LDA 


=XDATA+5 


Get address of DATA+5 into A 
register 


COOO 
7EFF 


LDA 


=X-$100 


Get 15-bit negative of lOOig 
into A register 


COOO 
5820 


LDA 


=AX 


Get ASCII constant X into A 
register 
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5.1.1.2 Absolute: One Word 



As was mentioned before, there are both one- word and two- word instructions for 
the Storage Reference Class. Let's examine the absolute mode of addressing in 
its one-word form. The format for this mode of addressing is: 



15 



Bit 



F Q I A 



Instruction 
Relative bit = 0. 



A is a non-zero 



Indirect bit is 

The F field remains the same as in constant mode, that is, it signifies the type of 
instruction within this class used. The relative bit and the indirect bit are also 
0's for this class. However, A is non-zero (See Figure 12). It may have been 
noticed now that this one- word type instruction has A non-zero where the con- 
stant mode example had A as zero and was a two- word type. The actual value in 
A will be the absolute address. Notice the size of A . It is only eight bits which 
means that the range of numbers in hexadecimal is from 01 to FF. In decimal 
this gives a range from 1 to 255. This is the limitation on this mode of addressing. 
Its advantage is its one- word length. To implement this absolute region from 
core location 01 toFF, all operating systems for the 1700 define this area as being 
the Communications Region. In this region are placed all system masks and all 
references to other points in the system allowing quick access through this region 
with this mode of addressing. 



Example: 






START 


LDA- 


$21 




r STA- 


$EC 



The contents of location 21^g in the absolute communications region is moved to 
core location EC^g. The minus sign as an opcode terminator signals the assem- 
bler to form a one-word instruction with the A field set to the address. The 
example above generates two one- word instructions: 



Example: 



This example clears index register I. Since I is core location $FF which is in 
the communications region, all references to I will use absolute one- word ad- 
dressing. 





60EC 


LDA 


=N0 


STA- 


$FF 
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The base address, for one-word absolute mode of addressing cannot be since a 
delta of results in a two- word instruction at run time. 



Example: 



LDA- 



$4F-$50+l 



This results in base address of which is an assembly error. The base address 
must be 01 to FF at run time. 



5.1.1.3 Absolute: One Word Indirect 

This mode of addressing is the indirect version of the absolute one-word. Its 
format, then, will be the same as for one-word absolute; however, bit 10 (the 
indirect bit) is set. Its base address, then, is not A but the contents of A and 
further, if the high order bit of the contents of A is a 1 then the indirect search 
will continue. This mode of addressing is extensively used where locations in the 
communications region contain addresses of other programs. The reference to 
these other programs is made by the use of the one-word absolute indirect mode 
of addressing through the communications region. 

Example: Assume location Eg in the communications region always contains the 
address of a desired routine. The routine can then be entered by: 



JMP- 



($E6) 



5. 1. 1. 4 Absolute: Two Word 

Since it is necessary to be able to absolutely address any core location from any 
other core location, it takes a second word for the absolute mode of addressing to 
specify the absolute address. The format for absolute two- word mode of ad- 
dressing is: 





k ip 4 


g 














F 


1 Q 


I 






















M 



P+l I M ^Address Placed 

in P+l 
r = 
ind = 1 
A = oo 16 

Again, F will specify the particular instruction, A will be 0, the relative bit (bit 
11) is 0, and the indirect bit (bit 10) is set. The second word of the instruction 
will contain the actual absolute address. Since the limit for allowable core in the 
1700 is 32,767, only 15 of the 16 bits in the second word are utilized for this 
absolute address. For absolute two-word bit #15 of the second word will be 0. 
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5.1.1.4 

Example: 

COUNT 

START LDA+ COUNT 

The + opcode terminator signals the assembler that the base address must be 
placed in P+l. The base address, then, is (P+l). Notice (Figure 12) that this is 
really the indirect case for constant mode. 

The address COUNT is placed in the second word. If the assembler's program 
counter for COUNT is at 0033, then at 0034 the assembler would generate: 

C400 
0033 

START STA+ $7F32-41 

The address is calculated as 7F32^g-29-^g or 7F09 and this address is placed in 
the second word of the instruction: 

At START location 6400 

7F09 

Example: Add lOOO* Q to the contents of core location 1000. 

LDA+ $1000 

ADD =N1000 

STA+ $1000 

5.1.1.5 Absolute: Two Word Indirect 

With indirect addressing the base address does not contain the operand itself, but 
rather this base address contains the address of the operand. Notice from Fig- 
ure 12 that two- word absolute is actually a case of constant mode indirect. Instead 
of base address being P+l as in constant mode, the search is made into P+l for 
the base address. The indirect bit which is set for two-word absolute mode is 
actually a case of constant mode indirect. Indirect addressing, however, can be 
multi-level; that is the search may continue from address to address to find the 
final base address. The continuation of this indirect search is accomplished each 
time bit 15, the high order bit, of the base address is a 1 and the indirect bit (bit 
10) is set. Using this high order bit of the address as an indirect flag is possible 
since only the low order 15 bits of this address can contain another address. Since 
the indirect bit is already set for the two-word absolute mode of addressing, the 
use of parentheses in the address field for this mode of addressing will cause bit 
15 of the second word to be set. This forms two-word absolute indirect mode of 
addressing. 

Example: 

TAG - - Assume TAG contains 0400 

START LDA+ (TAG) 
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If TAG is at the absolute location 0301, this code is generated: 

302 C400 

303 8301 

The high order bit of 303 is set. The contents of 303 is examined at run time and 
since the high order bit is set, the search for abase address continues. The con- 
tents of 301 is brought out, and if the high order bit is a 1, the search would con- 
tinue; in this case, however, the high order bit is a 0, so 400 is the base address. 
The effect of this instruction, then, is to load A with the contents of 0400. 

Example: Assume the following values in core: 

Core Value 



500 


C400 


501 


COlO 


400F 


3407 


4010 


8501 



If the contents of core location 500 were executed as the first word of a two- word 
instruction, the computer would be in an endless loop searching for an address. 
The instruction at core location 500 is: 

LDA+ ($4010) 

Since this is two-word absolute indirect, the search continues to core location 
4010 for an address. Bit 15 is set in core location 4010, so the search continues 
to 501, then back to 4010, etc. This condition is catastrophic, of course, but it 
illustrates the fact that the search for an address will continue until bit 15 is a 0; 
then this cell contains the base address. 

5. 1. 1. 6 Relative: One Word 

^ S ^ J There are two types of relocation associated with programs. One is called pro- 
gram relocation which means that the assembler begins the assembly with its 
program counter equal to zero so that this program, when it is loaded into core 
by the relocating linking loader, can be relocated anywhere. This program re- 
location is strictly a function of the assembler and the loader. This ability allows 
the program to be loaded anywhere into the core and run. Once loaded, the ability 
to take the same program and move it from one area of core to another and the 
program still run, is not a function of the loader. This type of relocation is known 
as dynamic relocation or "run anywhere". In process control programs, generally 
many programs are put on a mass storage device with a common area of core 
allotted for running these programs at any time. To allow proper allocation of 
this core area the programs on the mass storage device should be run anywhere 
so they can fit into space available in the common area rather than in a particular 
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[ area of the common core. Achievement of run anywhere programs is the result 

K-J of the use of the relative mode of addressing in the 1700. For the one- word rela- 

tive mode of addressing A will contain a signed increment that when added to P 
will yield the base address. The base address is made relative to P or where the 
program instruction presently is so that if the whole program is moved, the same 
relative distance is maintained between instructions/data and the base address 
found in exactly the same manner, since P is variable. The format for the one- 
word relative commands is: 

Contains signed 8-bit 
increment 

The limitation for this one-word relative mode of addressing is the size of A . 
Since A is 8 bits and signed, the range from P is +7F to 80 (-7F), or ±127^q. 

Example: 

LOOP - 



F 1 QI A 



O o 



JMP* LOOP 

If the JMP instruction is -127^q locations back or less, the one-word relative form 
can be used (and is preferred). Assume the program counter is at OlOO^g for 
LOOP and at 0143-^ for the JMP instruction, then the JMP instruction decodes at: 

( K _) 18BC Note: A is BC which is -43ie hi 8 bits. 

The * opcode terminator is used to signify to the assembler one-word relative 
mode of addressing. 

Example: Consider the same basic structure but coded absolutely, then rela- 
tively. Assume the distance from LOOP to LAST is less than 127 ^q. 

a) LOOP 



LAST JMP+ LOOP 

b) LOOP 

LAST JMP* LOOP 

For a) above, the routine could not be moved to another core location once loaded 
because with two- word absolute used with the JMP instruction, the absolute ad- 
dress placed in the second cell would cause a jump back to the original location 
of LOOP. But in case b), the incremental difference placed in A for JMP* LOOP, 
and since the distance between LOOP and LAST will not change if the whole routine 
is moved, the program will jump to the new location of LOOP, b), then, is "run 
anywhere" where a) is not. 
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5. 1. 1. 7 Relative: One Word Indirect 

This mode of addressing is an extension of the one-word relative to the indirect 
mode; the relative bit is set, the indirect bit is set, and A is non-zero (see Fig- 
ure 12). With the base address found as in one-word relative (P+A) a further 
search is made in this address location for the base address. The indirect bit is 
set and the search will continue if the high order bit in the contents of P+A con- 
tains a one. 

Example: 

ADDR - - Contains an address- 

Assume 0600. 



JMP* (ADDR) 

For this example ADDR must be w ithin 127 io of the JMP instruction and ADDR 
contains the address, 0600, to which control will pass. This routine jumps to 
location 600 and continues program execution from there. 

5.1.1.8 Relative: Two Word 

Two-word relative mode of addressing is used when the difference between the 
instruction and the address is greater than the limitations imposed by one-word 
relative, that is greater than +127io» Two words are necessary and in the second 
word of the instruction is placed the difference between that word and the address. 
The base address is then P+l+M where M is the contents of P+l. 

Example: 

LOOP - \ +» Assume PC-0100 

More than 127 io 




JMP LOOP ►Assume PC-0400 

Two word relative mode of addressing is used here since the difference between 
the JMP instruction and LOOP is greater than -7F. The above JMP LOOP would 
decode as: 

400- 1800 

401- FCFE 

Notice that the difference between P+l and LOOP is placed in P+l. 



L. 
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5. 1. 1. 9 Relative; Two Word Indirect 

This mode of addressing is the extension of the two-word relative to the indirect 
mode; the relative bit is set, the indirect bit is set and A =00 since this is a two- 
word instruction. With the base address found as in two- word relative, a further 
search is made in this address location for the base address. The base address 
is then (P+l+M). The search will continue if the high order bit of the contents of 
P+l+M contains a one since the indirect bit is set. 

Example : 

ADDR - - Contains an address- 

Assume 0600. 



JMP (ADDR) 

ADDR can be any distance from the JMP instruction and ADDR contains the ad- 
dress, 0600, to which control will pass. 

5. 1. 1. 10 Review of Addressing Modes 

A cross check back through Reference 1, Appendix A, page 3-4 will show that the 
Computer Reference Manual describes the storage reference class as having 7 
modes of addressing. A count from Figure 12 here shows 9 distinct modes of 
(j addressing. Although a seeming conflict exists, there is really none. From the 

viewpoint of basic machine language, there are only 7 modes since two-word 
absolute indirect to the basic machine is nothing more than an extension of two- 
word absolute in the indirect mode and both relative modes can be grouped to- 
gether as one. When considering the manner in which the programmer must 
specify the different modes to the assembler, there are 9 different combinations 
as described. Some of the terminology also differs between this training manual 
which essentially follows the terminology of the assembler manuals and the ter- 
minology used in the computer reference manual. The basic difference in ter- 
minology is: 

Storage Mode is the same as Two- Word Absolute 
Absolute Mode is the same as One- Word Absolute 
Indirect is the same as One- Word Absolute Indirect 
Relative Mode is the same as One- Word Relative 
16- Bit Relative is the same as Two- Word Relative. 

5. 1. 1. 11 Indexing 

Two index registers are available, the Q register and the I register which is 
actually core location FF. The contents of these registers can be used to modify 
the base address to form an effective address. This indexing, or address modi- 
fication is accomplished simply by adding the contents of the specified index 
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register (either Q or I or both) to the base address. If indirect addressing is 
specified, the search is made to find the final base address before indexing is 
done. This simplified flow chart illustrates this: 



Get 

Base 

Address 




Indirect 
Bit Set? 



Yes 



Get Contents 
of Base Ad- 
dress 




Bit 15 = 1? 



No 



No 




Index 
Q? 



Yes 



AddQ 
to Base 
Address 



No 



Index 
I? 



Yes 



-ta 



Add I to 
Base Ad- 
dress 



No 



This is 

Effective 

Address 



The use of indexing is wide- spread principally for forming repetitive loops for 
the type of work that would otherwise require an inordinate amount of repetitive 
programming. 

Example : 

Suppose the problem is to add together a series of numbers located in consecutive 
memory locations 1000 thru 1002 and then store the result into a location called 
TEMP. This routine would accomplish the additions: 



TEMP 








Reserve Temporary Lo 


START 


LDA+ 


$1000 


cation 




ADD+ 


$1001 






ADD+ 


$1002 






STA* 


TEMP 





If the series of numbers to be added was much longer, however, the length of the 
program, due to the number of ADD instructions, would be prohibitive. The same 
problem, with the numbers to be added in core 1000 thru 2000, ignoring overflow, 
and with the instructions covered so far would be solved with an indexed loop: 



TEMP 








Reserve temporary loc 


START 


LDQ 


=X$2000-$1000 


Difference in Q 




LDA+ 


$1000 




LOOP 


ADD+ 


$1000, Q 






ADQ 


=N-1 


Decrease Q by 1 




SQZ 


DONE-*-l 


Finished? 




JMP* 


LOOP 


No 


DONE 


STA* 


TEMP 


Yes 



r 
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Here, Q is set up as the index register used. The , Q in the address field signifies 
Q register indexing, and the assembler will set bit 9 in this instruction word. Q 
contains initially the difference between the lower and upper core locations of the 
numbers to be added. For each pass through the loop, Q is decreased by 1 allowing 
the next lower core location contents to be added in turn. The sequence of addition 
is: (1000) from the LDA instruction, (2000) from B.A. * of 1000 +Q which is 
initially 1000, (1FFF) from B. A. of 1000 +Q which is now 1 less or 0FFF, 

(1FFE) , till (1001). When Q is decreased to 0, the SQZ instruction skips out 

of the loop. 

If Q were not available at this point in the program, I could be used: 

Temporary storage 

Index Register I 

Can use either I or $FF 



TEMP 








START 


LDA 


=X$2000-$1000 




STA- 


$FF 




LDA+ 


$1000 


LOOP 


ADD+ 


$1000,1 




STA* 


TEMP 




LDA- 


I 




ADD 


=N-1 




STA- 


I 




SAZ 


ENDIT-*-l 




LDA* 


TEMP 




JMP* 


LOOP 



ENDIT 



Result is in TEMP 



r 



The , I in the address field signifies to the assembler that I register indexing is to 
be used and bit 8 in the machine language word is set. 

I cannot be manipulated as easily as Q. TEMP is used to store the partial results 
of the adds when the A register is used to manipulate the contents of the index 
register I. 

The , B in the address field signifies to the assembler that both Q and I indexing 
are to be used. 

The use of Q as an index register does not increase the execution time, but use 
of I indexing takes 1. 1 microseconds longer. 



*Base address 
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Addressing Problem / 

Given are contents of the index registers and some core locations. 
Contents of any locations not shown is zero. What will the A register 
contain after each instruction is executed? 

(I)=0020 (1000) = 0120' 

(Q)=0120 (0240) = 1234 

(1234) = 02EI) 
(0260) = llll" 
(1254) = 2311 
(1111) = 9000 

(A)= 



a. 


LDA+ $240 


b. 


LDA+ ($240) 


c. 


LDA+ ($240), I 


d. 


LDA+ ($1111), B 
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ft 
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DELTA 






M 






ft 
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ft 




ft 
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* 










ft 




ft 


* 


*MNE**OPERATlON* 




+ 


* 


*MODE* 


**BA* ( »OP**ADRft 


ft 




ft 


* 








* 


+ 










ft 




ft 


1 


JMP 


EFAr*P 







= 00 


CONSTANT* 


P*l 


s 




ft 


Ol 


ft 


2 


MUI 


(EFA)X(A)r»QA 







#00 


ABSOLUTE 


DELTA 






ft 


1 


ft 


3 


DVI 


<QA)/(EFA)*A»I 


3£Mr»Q 


4 


=00 


STORAGE 


M ♦ 






ft 


-3 


ft 


4 


STQ 


(Q)r>EFA 




4 


= 00 


STORAGE INDTRECT 


(M) ♦ 


( 


) 


» 




ft 


5 


RTJ 


P + lv^r»EFA»EFA 


♦UP 


4 


#00 


INDIRECT 


(DELTA) - 


( 


) 


» 




ft 


6 


STA 


(A)^EFA 




8 


sOO 


LONG RELATIVE 


P*l+M 






« 




ft 


7 


SPA 


(A)r»EFA,PARITYr»A 


8 


#00 


RELATIVE 


P*DELTA * 






ft 




ft 


8 


ADD 


(A) ♦(EFA>r»A 




C 


=00 


LONG RELATIVE INDIRECT 


<P*I*M) 


( 


) 


# 




ft 


9 


SUB 


(A)-(EFA)r*A 




C 


#00 


RELATIVE INDIRECT 


(P+DELTA)* 


( 


) 


ft 




ft 


A 


AND 


<A)A(EFA)r*A 




+ 


«EFA» 








ft 




* 


B 


EOR 


(A)-y-(EFA)r>A 




♦ 


BA 








« 




ft 


C 


LDA 


(EFA)r»A 




♦ I 


B4 


*♦<!) 








ft 




ft 


D 


RAO 


<EFA)*1*EFA 




♦ 2 


BAMQ) 








ft 




ft 


E 


LDQ 


<EFA)*Q 




♦ 3 


8A*(Q)*(I) 








ft 




ft 
ft 


F 


ADQ 


<EFA)*(Q)r>Q 
















ft 

ft 



en 
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5. 1. 2 Instructions in the Storage Reference Class 

The instructions for the storage reference class are: 
F F 



1 


JMP 


Jump 


9 


SUB 


Subtract from A 


2 


MUI 


Multiply 


A 


AND 


AND with A 


3 


DVI 


Divide Integer 


B 


EOR 


Exclusive OR 


4 


STQ 


Store Q 






with A 


5 


RTJ 


Return Jump 


C 


LDA 


Load A 


6 


STA 


Store A 


D 


RAO 


Replace Add 1 


7 


SPA 


Store A, Parity 






in Storage 






to A 


E 


LDQ 


Load Q 


8 


ADD 


Add to A 


F 


ADQ 


Add to Q 



Any of the nine addressing modes, plus indexing, can be used on all of these in- 
structions. 
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5.1.2.1 LDA, LDQ, STA, STQ, AND SPA Instructions 

These instructions are the basic load and store instructions. For the load instruc- 
tions, either LDA or LDQ, the contents of the effective address specified is loaded 
into the registers, either A or Q, as per the specific instruction and the contents 
of the storage location are not altered. The STA and STQ registers store the 
contents of the register into the effective address, replacing what was in this core 
address with the information that was in the register. For the store instructions 
STA and STQ, the original contents of the A or Q registers are not changed. The 
SPA instruction is the same as the STA instruction with the exception that after 
the information from A is stored into the core address specified, A is cleared and 
the parity of the original contents of A is returned to bit of A. This parity bit 
is the value that would be necessary to make the total number of bits of the original 
contents of A plus this bit, odd. This parity bit is not necessarily the same as 
the parity bit that will appear in core for this data word since core might contain 
a program protect bit. In fact, this bit is the exclusive OR of the core parity bit 
and program protect bit. 

Any method of addressing may be used with these instructions. 

Example: 



Location 



Opcode 
LDA 



Address 
TAG 



Comments 



Contents of A is replaced by the contents of core location labeled TAG. 
tents of TAG is not changed. 



The con- 
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Location Opcode Address Comments 

SPA TAG1 

The contents of A (assume F2F7) is stored into the core location labeled TAG1. 
Then A is cleared and the parity of the original contents of A is returned to A, bit 
position 0. The parity returned is 1. 

5.1.2.2 ADD, ADQ, SUB, MUI and DVI Instructions 

These instructions are the primary arithmetic instructions for the 1700. Data 
from core can be added to the A register with the ADD instruction, or to the Q 
register with the ADQ instruction. Data from core can be subtracted from the 
A register with the SUB instruction. Notice there is no instruction for direct sub- 
traction from Q. These arithmetic operations can cause overflow (refer to 
Chapter II, Section 4) . 



C 



Example: 








Location 


Opcode 


Address 


Comment 




LDQ 


TAG 






ADQ 


=N-6 





Using Constant mode of addressing for the ADQ produced an effective subtraction 
from Q. Q is loaded with the contents of core location TAG and the number -6 is 
added to Q. 

The MUI instruction will multiply an operand in core by the contents of the A reg- 
ister. Both of these operands are 16 bits long, producing a double length, 32 bit 
product in the Q and A registers. The Q register contains the most significant 
portion of the product and the sign of the product and the A register contains the 
least significant portion of the product. The MUI instruction cannot cause over- 
flow. The MUI instruction destroys the original contents of Q. 

Example: 

Location Opcode Address Comment 

LDA =N$FF31 -$CE to A register 

MUI =N$31 Multiply by 31 

Result is (Q register)=FFFF 
(A register)=D891 

The result in the double length register then is -216~E-^q. 

Negative zero can be produced by the MUI instruction: 

(+0) x (-N) = (-0) 
(-N) x (+0) = (-0) 
(-0) x (+N) = (-0) 
(+N) x (-0) = (-0) 
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Division of integers is accomplished with the DVI instruction. It divides the 
double length QA register by the contents of a core location. The Q register must 
contain the most significant portion and the sign of the dividend and A must contain 
the least significant portion of the dividend. The signed quotient will be placed in 
the A register and the signed remainder will be placed in the Q register after 
division occurs. The DVI instruction can cause overflow, if the quotient is larger 
than 7FFF in absolute value. 

Example: 



Location 


Opcode 


Address 


Comment 




LDQ 


=N$FFFF 


=N in address field indi- 




LDA 


=N$FFF0 


cates CONSTANT MODE 




DVI 


=N$FFFA 


OF ADDRESSING used. 
The number following =N 
is the operand. 



This example divides -15 by -5. Notice that Q had to be set to extend the sign to 
32 bits. Result is 0003 in A and 0000 in Q. 

5. 1. 2. 3 AND and EOR Instructions 

These instructions perform logical manipulation of data from the specified core 
location with the contents of the A register. The AND instruction performs a 
logical product operation; its bit by bit truth table is: 

AAB 





A B 
1 1 




1 




1 







Example: 






Operand 1 — 




Operand 2 — 




Logical Product 



15 



Bit 







1111 0010 1001 0111 
0011 1111 1100 0000 
0011 0010 1000 0000 



The AND instruction is used to extract a certain field of bits. In the example 
above, a field from bit 6 through 13 is extracted from operand 1. Operand 2 con- 
tains ones in these bit positions and 0's in the remaining bit positions to block out 
the unwanted bits. Operand 2 is referred to as a mask. 
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Example: Examine bits 4 thru 7 of core location TAG for all zeroes. 
Location Opcode Address Comment 



LDA 


TAG 


Load (TAG) in A register 


AND 


=N$00F0 


AND with A Mask 


SAZ 


YES-*-l 


Test for zeroes 


JMP 


NO 





YES 



L 



The EOR logical instruction performs an exclusive OR bit by bit. The logical 
rules for an exclusive OR are: 

A^B 


1 
1 


A is produced as a result of a match between the two bits and a 1 is produced as 
a result of a mismatch. This instruction is frequently used to test for a particular 
bit pattern. 

Example: Test for 10110 in bit positions 3 thru 7 of contents of core location 
DATA. 



A 


B 


1 


1 


1 








1 









Location 


Opcode 


Address 


Comments 




LDA 


DATA 






AND 


=N$00F8 


Mask out all except 3-7. 




EOR 


=N$00B0 


Test for bits 10110 




SAZ 


YES-*-l 





YES 

If the exact bit pattern 10110 was present in bit positions 3 through 7, all the bits 
in both operands would match, and a positive zero will be in the A register and the 
program will skip to YES. 

An instruction that performs an inclusive OR is not specifically available in the 
storage reference class. The truth table for the inclusive OR is: 

AVB 



A 


B 


1 


1 


1 








1 









1 
1 
1 



A 1 is produced if a 1 appears in either or both operands. Notice that the inclu- 
sive OR logical function can be obtained by the combination of the logical product 
and exclusive OR functions. 
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Example: Form the inclusive OR bit- by-bit of the contents of core location AA 



and BB. 



Location 



TEMP 



Opcode 



LDA 

AND 

STA 

LDA 

EOR 

ADD 



Address 



AA 

BB 

TEMP 

AA 

BB 

TEMP 



Comment 



Logical Product AA & BB 
Store Temporarily 
Exclusive OR AA & BB 

Combine them. Inclusive 
OR is now in A. 



5. 1. 2. 4 JMP and RTJ Instructions 

These instructions alter the path of program flow. JMP is an unconditional pro- 
gram branch to the effective address. The RTJ, besides branching control to 
another core location, also provides the link by which control can be returned to 
the instruction following the RTJ instruction. This allows program flow from a 
main program to a closed subroutine and back again to the main program. This 
is illustrated below: 



Main 
Program 
Address 



Main Program 
a 



RTJ 



Effective 
Address 



=0025 



16 



P+l 



r 



P+2 



0025 



Subroutine 



Computer 
stores P+l or 
P+2 here 



1st Instruction 

of 

Subroutine 



Next to Last 
Instruction 
of Subroutine 



JMP 



Indirect 
Address 
=0025 16 
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The subroutine is structured with its first location left open to allow the address 
(P+l or P+2) to be placed by the RTJ instruction. Program control is then given 
to the second cell of the subroutine. By using a jump indirect through the first cell 
as the last instruction in the subroutine, program control will be given to the next 
executable instruction following the RTJ in the main program. This flow is in- 
dependent of the location of the RTJ instruction. 



Example: 
Location 



LOOP 



Opcode 
LDA 



Address 



TEN 



Comment 



JMP 



LOOP 



Simply jumps back to lo- 
cation LOOP 



BACK 



RTJ 



BACK1 



Sets BACK+2 into BACK1 
since mode of addressing 
is 2 word. 



BACK1 



Address BACK+2 is placed 
here. 



JMP 



(BACK1) 



Will jump not to location 
BACK1, but to location 
whose address is in BACK1 
which is BACK+2. 



To specify indirect mode of addressing the address is placed in parentheses as in 
the above example. This means that the specified address (in this case, BACKl) 
itself contains the address that is desired. More will be said on addressing later. 

5. 1. 2. 5 RAO Instructions 

This RAO instruction is used to increase the contents of the effective address by 
1. This instruction is very useful as a counter where a memory location is ini- 
tialized or preset and the RAO instruction increases the count in this memory cell 
each time a desired condition occurs (number of times through a loop, etc.). 
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Example: 

Location 

COUNT 



Opcode 




Address 



Comment 



LOOP 



LDA 



TEST, Q 



SAZ 


2 


Skips to RAO COUNT if A 
is zero 


JMP 


LOOP 




RAO 


COUNT 




JMP 


LOOP 





In this example the contents of core location COUNT is increased by 1 each time 
the A register is found to be zero. This RAO (Replace and Add One) instruction 
can only add one to the contents of the designated core location and does not change 
the contents of any of the registers. This instruction can cause overflow and, as 
such, is very useful for loop control. 

Example: Loop through a given portion of a program 12 times then jump to core 
location NEXT. It is necessary to preset a COUNT cell such that in- 
creasing it by 1 will not cause overflow until it has been increased 12 
times. The largest positive number minus 11 then is preset into 
COUNT. 



Location 



Opcode 

SOV 
LDA 

STA 



Address 



=X$7FFF-11 

COUNT 



Comment 

Turn off overflow if set 



LOOP 





RAO 


COUNT 




SOV 


NEXT-*' 




JMP 


LOOP 


COUNT 








NEXT 


- 





Overflow will occur the 12th time the RAO instruction is performed. 



5-24 



5.1.3 



5. 1. 3 Execution Times 







EXECUTION TIME 




INSTRUCTION 


(microseconds) * 


LDA 


Load A 


2.2 


STA 


Store A 


2.2 


LDQ 


Load Q 


2.2 


STQ 


Store Q 


2.2 


ADD 


Add A 


2.2 


SUB 


Subtract 


2.2 


ADQ 


AddQ 


2.2 


AND 


AND with A 


2.2 


EOR 


Exclusive OR with A 


2.2 


RAO 


Replace Add One in Storage 


3.3 


MUI 


Multiply Integer 


7.0 


JMP 


Jump 


1.1 


RTJ 


Return Jump 


2.2 


DVI 


Divide Integer 


9.0 


SPA 


Store A, Parity to A 


2.2 



o 



Timings are for one- word instructions, 
two-word instruction. 



An additional cycle must be added for a 



Note the speed of the integer multiply and divide instructions, 
sidered very fast for the computer hardware. 



These are con- 



*Add 1. 1 microsecond if Storage Index Register is used. 
Add 1. 1 microsecond for each level of Indirect Addressing. 



u. 



5-25 



CO 





* 










* 










* 










* 


rrrrr^rrrrrr 




* 


i 


ARITHMETIC TESTS 




* 


t 




*TEST* 




* 





SAZ 


(A)=ZERO 




* 


1 


SAN 


(A)^ZERO 




* 


2 


SAP 


(A)=POSITIVE 


1 


* 


3 


SAM 


(A)=NEGATIVE 


to 

05 


* 


4 


SQZ 


(Q)=ZERO 




* 


5 


SQN 


(Q)^ZERO 


-: 


* 


6 


SQP 


(Q)=POSITIVE 




* 


7 


SQM 


(Q)=NEGATIVE 



F=0 
(P)=* * * * 



SKIPS 
Fl=l F2 SKIP COUNT 



8 


sws 


9 


SWN 


A 


sov 


B 


SNO 


C 


SPE 


D 


SNP 


E 


SPF 


F 


SNF 



MACHINE STATE TESTS 

*TEST* 
SKIP SWITCH ON 
SKIP SWITCH OFF 
OVERFLOW 
NOT OVERFLOW 
PARITY ERROR 
NOT PARITY ERROR 
PROTECT FAULT 
NOT PROTECT FAULT 



5.2 



5.2 SKIP CLASS INSTRUCTIONS 

These instructions are used to make conditional tests and skip forward depending on 
whether the instruction meets the actual condition being tested. The format for these in- 
structions appears below: 



15 



12 11 



6 5 4 










1 




V 









F 



-7v- 



V 

Instruction 
Fl 



-/\. 



^r 



V\- 



"V7 



Sub- Instruction Skip Count 

F2 



Notice the skip count is only four bits which allows a skip count of only 15. The skip 
count is not signed so the instructions will only allow a skip in the forward direction. 

If the skip condition is met, program control proceeds to P + 1 + skip count. If the skip 
condition is not met, program control continues from P+l. 

5. 2. 1 A and Q Skip Tests 



The following types of cond 


itional tests are 


available on the A and Q regi 


F2' 











0000 


SAZ 


A=+0 


1 


0001 


SAN 


A^+0 


2 


0010 


SAP 


A= + 


3 


0011 


SAM 


A=- 


4 


0100 


SQZ 


Q=+0 


5 


0101 


SQN 


Q^+0 


6 


0110 


SQP 


Q= + 


7 


0111 


SQM 


Q=- 


Example: 








Location 


Opcode 


Address 


Comments 


START 


LDA 


=N$0080 


Loads 0080 into A 




ARS 


4 






SAZ 


1 


1 is the Skip Count 




ARS 


4 


will not skip to TAG 


TAG 


SAZ 


TAGl-*-l 


will skip to TAG1 



TAG1 

The TAGl-*-l address is a form peculiar only to the utility assembler. With this 
form the assembler is being directed to form a skip count to TAG1, which has 
some program counter value. This counter value, minus the current location of 



r 
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'''the SAZ instructions (which is some program counter valueless thanTAGl), minus 
one more, forms the skip count. The -1 is used to compensate for the +1 in the V 

skip formula P+l+skip count. When using the macro assembler, the address need 
only be TAG1 as the macro assembler will automatically calculate the skip count. 
For all cases the distance skipped (to TAG1 in this example) must be no greater 
than 16 locations forward from the location of the skip command. The macro 
assembler will also accept the -*-l form. 

5.2.2 Skip Switch Tests 

The SWS and SWN instructions test the condition of the skip switch located on the 
programmer's panel. This switch can be used to alter program flow from the 
panel. 

Example: 

Location Opcode Address Comments 



START 



TAG SWS GO-*-l 



GO 

TAG1 SWN GO!-*-l 



GOl 

The code between TAG and GO will be skipped at run time if the skip switch on 
the programmer's panel is set. It would be executed if the switch were not set. 

The code between TAG1 and GOl will be skipped if the skip switch on the pro- 
grammer's panel is not set. It will not be skipped if the switch is set. 

5. 2. 3 Overflow Skip Tests 

The SOV (F2=A) and SNO (F2=B) instructions test the state of the overflow indi- 
cator. Refer to Chapter II, Section 4, for a discussion of those arithmetic 
operations causing overflow. The overflow indicator is cleared upon execution 
of these instructions. 



r~^ 
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Example: 








Location 


Opcode 


Address 


Comments 


START 


LDA 


OP1 






ADD 


OP2 






SNO 


TAG-*-l 




CORR 


- 


- 




TAG 


ADD 


OP3 






SOV 


ERROR- *-l 






JMP 


OK 





ERROR 



OP1 
OP2 
OP3 
OK 



In the above example, two numbers are added and if no overflow occurred, the 
instructions between CORR and TAG will be skipped and a third number will be 
added. The overflow indicator is again checked and if overflow had occurred, 
the routine would skip to ERROR. The overflow indicator once set, remains set 
until tested with either an SOV or SNO instruction. 



5. 2. 4 Parity and Program Protect Indicator Tests 

The SPE (F2=C) and SNP (F2=D) instructions will test for a storage parity error 
and the SPF (F2=E) and SNF (F2=F) instructions will test for program protect 
fault errors. 



Example : 








Location 


Opcode 


Address 


Comments 


START 


SPE 


PAR-*-l 






SPF 


PROT-*-l 






JMP 


ERROR 




PAR 


JMP 


PARITY 




PROT 


JMP 


PROTEK 





If either a parity error or a program protect fault occurs, an interrupt is generated 
on line 0. Since both interrupts can occur on the same line, the interrupt pro- 
cessor for this line must distinguish between the two. This example illustrates 
how this might be done with program control going to the location named PARITY 
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ifa parity error is found, and program control jumping to core location named 
PROTEKif the protection fault caused the interrupt. If neither interrupt was found 
by this process, program control would jump to some error routine to service what 
is apparently a ghost interrupt. The parity and protect indicators (both the inter- 
rupt signal and the programmer's panel fault indicators) will clear when these in- 
structions are executed. 



Problem: 

MOVE 
LP1 



The following routine will move how many numbers ? From what core 
locations to what core locations ? 





LDQ 

LDA+ 

STA+ 

ADQ 

SQM 

JMP* 

JMP* 





=N$1000 
$1000, Q 
$3000, Q 
=N-1 
1 

LP1 
(MOVE) 



Problem: 

SUM 
LOOP 



DONE 
Problem: 

CHNG 



The following routine sums how many numbers ? 
locations? Where does it store the answer? 



From what core 



LDQ 

LDA 

ADD+ 

ADQ 

SQM 

JMP* 

STA+ 



=X$2000-$1000 

=N$ 

$1000, Q 

=N-1 

DONE-*-l 

LOOP 

$3000 



The following routine moves how many numbers ? From which core 
locations to where? 



LP2 



ADDR1 
ADDR 





LDA 

STA* 

LDA 

STA* 

LDA+ 

LDQ+ 

STA+ 

STQ+ 

RAO* 

LDA* 

SUB 

STA* 

SUB 

SAM 

JMP* 





JMP* 





=N$1000 

ADDR1 

=N$4000 

ADDR 

(ADDR1) 

(ADDR) 

(ADDR) 

(ADDR1) 

ADDR1 

ADDR 

=N1 

ADDR 

=N$3000 

3 

LP2 





(CHNG) 



5-30 



n 



i 

CO 



SHIFTS 

ppSHIFT A 
SHIFT LEFTpl^fSHIFT Q 
F=0 F1=F m SHIFT COUNT 



rrrrrrrrrrrrrrrrrrrrrrrrw rrrr 

^ LEFT SHIFTS A RIGHT SHIFTS k DELAY * 

C ALS (A) LEFT 4 ARS (A) RIGHT 8 NOP 1. 1+SHIFT COUNT (. 1) * 

A QLS (Q) LEFT 2 QRS (Q) RIGHT * 

E LLS (QA) LEFT 6 LRS (QA) RIGHT * 

* 



to 



5.3 



5. 3 SHIFT CLASS INSTRUCTIONS 



These instructions are used to shift the data bit by bit either in the A register or the Q 
register singly or together. The data can be shifted either left or right bit by bit. For 
these instructions the format appears below: 



15 



F=0 



l=shift left _ 
0=shift right 



12 11 



6 










1111 


1 


1 






C 



F1=F 



l=shift A 
l=shift Q 



~v 

Shift Count 



Notice the shift count is five bits allowing a shift either way a maximum of 31 positions. 
The upper bit of the shift count will appear in the hex code as part of the second digit. 
For example, a 0F51 is an ARS $ instruction, not ARS 1. 

Left shifts are end around: the high order bit of the register is shifted around and into 
the low order bit of that register for single register shifts. For a double register shift, 
(Long Shift), the Q register is considered the most significant register and the A register 
the least significant register and on left shifts the high order bit of Q is shifted around 
into the low order bit of A. High bit of A is shifted left into the low order bit of Q. 



Right shifts are end off with sign extension. Bits shifted off the right end are lost, and 
the sign bit of the register is extended from the left. For long right shifts, the low bit 
(Bit 0) of Q is shifted into the high bit (Bit 15) of A and the sign (Bit 15) of Q is extended 
from the left. 

The mnemonics for the instructions in this class are: 



ARS 
QRS 
LRS 
ALS 
QLS 
LLS 



A Right Shift 

Q Right Shift 

Long Right Shift (QA) 

A Left Shift 

Q Left Shift 

Long Left Shift (QA) 
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Example: 

Location Opcode Address Comments 

~ i I 

ALS 8 

If the A register contained F302, execution of this instruction would 
shift the A register left 8 bits leaving 02F3. The high order bits of A 
moved end around into the low order bits of A. 

! i 

LRS 8 

If Q=8000 and A=AOF0, execution of this instruction extends the sign 

of Q to the right and the lower 8 bits of A would shift end off and be 

lost. Result is FF80,in Q, and 00A0 in A. 

I i 

Illegal LLS 40 Maximum number of shifts 



I I 

Legal QRS Is effectively a no opera- 



allowed is 31, 

Is ef 

tion 



5. 3. 1 Timing for Shift Class Instructions 

The time for shift class instruction execution is: 

For long shifts (QA together) 1. 1 + . 2 x shift count 

For single register shifts (Q or A) 1. 1 + . 1 x shift count 



"^ 
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en 
l 

w 



INTERREGISTER 
LX 
F=0 Fl=8 PR AQM AQM 

ADDER CONTROLSfT** I ♦♦♦ ♦♦ | Tf^ DESTINATION REGISTERS 

++♦ r^ORIGIN REGISTERS 
Hi r^^OPERAND TWO 
jPT^OPERAND ONE 



TRANSFER 

40 CLR 0r**A,Q,M 

A0 TRA (A)r*A,Q,M 

90 TRQ (Q)T*A,Q,M 

88 TRM (M)f*-A,Q,M 

98 TRB Br*A,Q,M 

EXCLUSIVE OR 

70 EAQ (A)¥(Q)^A,Q,M 

68 EAM (A)V(M)f^A,Q,M 

78 EAB BV(A) [*A, Q, M 



TRANSFER COMPLIMENT 
80 SET -0r^A,Q,M 
60 TCA (A)NOTr**A,Q,M 
50 TCQ (Q)NOTl*"A,Q,M 
48 TCM (M)NOTf*A,Q,M 
58 TCB B NOTI^A, Q,M 

LOGICAL AND 
B0 LAQ (A)A(Q)C*A,Q,M 
A8 LAM (A)A(M)f* k A,Q,M 
B8 LAB B/\(A)f*A,Q,M 



B=INCLUSIVE OR OF (M)AND(Q). 



* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
COMPLIMENT LOGICAL AND * 
F0 CAQ ((A)A(Q))NOT[**A,Q,M 
E8 CAM ((A) A (M))NOTf**A, Q, M 
F8 CAB (BA(A))NOTr^A,Q,M * 

* 
* 



en 

CO 



SUM 

30 AAQ (A)+(Q)f**A,Q,M 

28 AAM (A)+(M)f*A,Q,M 

38 AAB B+CAJf^A^M 



( \ 

v / 
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5.4 INTERREGISTER CLASS INSTRUCTIONS 



This class of instructions performs arithmetic or logical manipulation with the contents 
of A, Q or M or any combination of the three. The format for this class of instruction is: 



Adder Control Lines 



Operand 1 

J Operand 2 



15 




12 


11 




8 


7 


6 


5 


4 


3 


2 


1 

















L 


X 
















F=0 






Fl=8 




P 


R 


A 


Q 


M 


A 


Q 


M 



Logical Product 
Exclusive OR — 




Origin 
Registers 



Destination 
Registers 



Since the adder can operate on only two operands and there are three possible origin 
registers, these three origin registers are considered as two operands, operand 1 and 
operand 2. Operand 1 includes bit 5 or the A register bit and it can have two forms: 



A (Bits) 

1 



Operand 1 

FFFF 
Contents of A 



If this bit 5 is a 0, then all l's are used as an operand and if bit 5 is a 1, then the contents 
of A is an operand. 

Operand 2 is the combination of bits 3 and 4 or the combination of the Q and M register 
bits : 



Q (Bit 4) 



M (Bit 3) 



Operand 2 
FFFF 



1 
1 


1 

1 


(M) 

(Q) 

Inclusive OR of Q & M 



If neither of these registers is specified, then all l's are used as the operand. If any one 
but not the other is specified, then the contents of that specified register is used. If both 
Q and M are specified, then the inclusive OR of Q and M is used as Operand 2. The bit 
by bit truth table for the inclusive OR is: 



A_ 

1 
1 






B^ 

1 

1 




AVB 

1 
1 
1 





Here a bit in either position yields a bit in the result. 
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Either A, Q or M, or any combination of these can be specified as the destination reg- 
isters. These are listed in any order and separated by commas in the address field. 

Since M is the interrupt mask register, the interregister instruction with M as a desti- 
nation register must itself be protected if the protect switch on the programmer's panel 
is on. Otherwise, a protect fault will occur. 

Formation of the operation itself comes from bits 6 and 7 of the instruction word. The 
operations possible are: 



LP (Bit 7) 



1 
1 



XR (Bit 6) 


1 

1 



Operation 

Arithmetic Sum 
Exclusive OR 
Logical Product 
Complement Logical Product 



Refer back to Section 5. 1. 2. 3 of this chapter for the truth tables of the logical product 
and the exclusive OR. All the possible combinations of different instructions in this class 
using these two operands number 22. The mnemonics assigned with the instructions in 
this class are: 



SET 

CLR 

TRA 

TRM 

TRQ 

TRB 

TCA 

TCM 

TCQ 

TCB 

AAM 

AAQ 

AAB 

EAM 

EAQ 

EAB 

LAM 

LAQ 

LAB 

CAM 

CAQ 

CAB 



Set to l's 

Clear to "0" 

Transfer A 

Transfer M 

Transfer Q 

Transfer QVM 

Transfer Complement A 

Transfer Complement M 

Transfer Complement Q 

Transfer Complement QVM 

Transfer Arithmetic Sum A, M 

Transfer Arithmetic Sum A, Q 

Transfer Arithmetic Sum A, Qv M 

Transfer Exclusive OR A, M 

Transfer Exclusive OR A, Q 

Transfer Exclusive OR A, Q V M 

Transfer Logical Product A, M 

Transfer Logical Product A, Q 

Transfer Logical Product A, QVM 

Transfer Complement Logical Product A, M 

Transfer Complement Logical Product A, Q 

Transfer Complement Logical Product A, QVM 
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Clears A 

So does this 

Clears A, Q and M 

Adds A to Q, puts result in A 

Puts complement of A into Q 

Transfers A to Q and M 

Set M to all l's 

Only affects overflow indicator — 

adds A and Q, puts result nowhere 



The following is an example of how a subroutine can pick up parameters from the calling 
routine. How does the subroutine pick up the parameters? Does it pick up the actual 
argument or the address of the argument? 

Calling Program: ^ 



Examples : 








LDA 


=NO 




CLR 


A 




CLR 


A,Q,M 




AAQ 


A 




TCA 


Q 




TRA 


Q,M 




SET 


M 




AAQ 





Problem: 







o 







LDA 


=xx 








STA 


ARG1 








LDA 


=XY 








STA 


ARG2 








LDA 


=XZ 








STA 


ARG3 




$500 




RTJ 


SUB 




$502 


ARG1 


o 


n** 


Address of X 


$503 


ARG2 





on» v 


Address of Y 


$504 


ARG3 





0i^ 


Address of Z 



$700 


X 


$701 


Y 


$702 


Z 



NUM 


10 


X data 


NUM 


12 


Y data 


NUM 


6 


Z data 



Addresses of parameters fall directly beneath the call to the subroutine. 
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Subroutine : 
SUB 





STA* 

STQ* 

LDA- 

STA* 

LDA* 

EOR 

STA* 

LDA* 

STA* 

RAO* 

LDA* 

STA* 

RAO* 

LDA* 

STA* 

LDA* 

INA 

AND 

STA* 





SAVEA+1 

SAVEQ+1 

$FF 

SAVEI+1 

SUB 

=N$8000 

SUB 

(SUB) 

SUBAG1 \° 

SUB 

(SUB) 

SUBAG2 \ '' 

SUB 

(SUB) 

SUBAG3 v o 

SUB 

I 

=N$7FFF • 

SUB 



SAVE I 

SAVEQ 
SAVEA 

SUBAG1 
SUBAG2 
SUBAG3 



LDA 

STA- 

LDQ 

LDA 

JMP* 

BSS 

BSS 

BSS 



=N0 

$FF 

=N0 

=N0 

(SUB) 

SUBAGl(l) 

SUBAG2(1) 

SUBAG3(1) 
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Problem: 

How many numbers does the following routine sort? In what order? From what core 
locations ? 



SORT 



BEGIN 



TEMP 



CHECK 



EXIT 



CLR 

STA- 

ENQ 

LDA+ 

SUB+ 

SAP 

LDA+ 

STA* 

LDA+ 

STA+ 

LDA 

STA+ 

INQ 

TRQ 

EOR 

SAZ 

JMP* 

LDA- 

INA 

STA- 

EOR 

SAZ 

ENQ 

ADQ- 

JMP* 

SLS 



A 

$FF 

1 

$500, Q 

$500,1 

CHECK-*-l 

$500, Q 

TEMP+1 

$500,1 

$500, Q 

=NO 

$500,1 

1 

A 

=N$10 

1 

BEGIN 

$FF 

1 

$FF 

=N$F 

EXIT-*-l 

1 

$FF 

BEGIN 



V 
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<^1 

* 






4 ARITHMETIC 

t 

A ENA . +-DELTA A 

C ENQ +-DELTA Q 

9 INA +-DELTA+(A)|*A 

D INQ +-DELTA+(Q)f**Q 



REGISTER REFERENCE 
F=0 Fl DELTA 



rrrHU rrrrrrrr 



INTERRUPT 






PROTECT 



I/O 



7 CPB CLEAR 2 INP i/O pA 

6 SPB SET 3 OUT (A)f*"l/0 

SLS SELECTIVE STOP 
B NOP 
*ONE INSTRUCTION DELAY 



4 EIN* ENABLE 

5 UN INHIBIT 
E EXI* EXIT 



(" > 
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5.5 REGISTER REFERENCE CLASS INSTRUCTIONS 



All the instructions in the class are one-word. The F field is always a zero and the Fl 
field will signify the particular instruction within this class. The format for the Register 
Reference Class of instructions is: 



F=0 


Fl 


A 


Instruction iL 
Code 



The instructions within this class are: 
Fl 



O 





1 

2 

3 

4 

5 

6 

7 

8 

9 

A 

B 

C 

D 

E 

F 



SLS 

INP 

OUT 

EIN 

UN 

SPB 

CPB 

INA 

ENA 

NOP 

ENQ 

INQ 

EXI 



Selective Stop 

SKIPS 

Input to A 

Output from A 

Enable Interrupt 

Inhibit Interrupt 

Set Program Protect 

Clear Program Protect 

INTERREGISTER 

Increase A 

Enter A 

No operation 

Enter Q 

Increase Q 

Exit Interrupt State 

SHIFTS 



The A field is available in this class of instructions. 



5. 5. 1 Instructions ENA, INA, ENQ and INQ 



These four instructions are used to either enter into or increase the A register 
or the Q register by the value in A • This value is signed allowing numbers of 
the magnitude plus or minus 127. 



e: 


LDA 


=N22 


Loads A with 16 ^g 




ENA 


22 


So does this 




SUB 


=N$1 


Decreases A by 1 




INA 


-1 


So does this 



V 
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Where applicable, these instructions should be used in place of storage reference 
class with constant mode as these take only one word and 1.1 microseconds to 
execute. 

The value in the address field is placed into A by the assembler. The ENA 22 
machine instruction equivalent is 0A16. 



5. 5. 2 Instructions SPB and CPE 

These instructions are used to either set or clear the protect bit (Bit 17) in mem- 
ory. For these instructions A is not used. The address of the core location 
which will have its protect bit either set or cleared must be in the Q register. If 
the program protect switch on the programmer panel is on, then these instructions 
must be protected. Otherwise, a program protect fault (interrupt on line 0, pro- 
tect fault indicator on panel) will occur and these instructions become no operations. 



Example: 


Clear the protect bits 


in core from 1000 to 2000. 


TEMP 










START 


LDQ 


=N$1000 




LOOP 


CPB 




Address h 




INQ 


1 






STQ* 


TEMP 






ADQ 


=N-$2000 




V 


SQZ 


DONE-*-l 


Finished? 




LDQ* 


TEMP 


No 




JMP* 


LOOP 





DONE 



Yes 



This particular routine is further simplified with the use of interregister class 
instructions* 



Problem: The CLRPB subroutine clears protect bits on what core area? 
Calling Program 





RTJ 


CLRPB 


LWA 


NUM 


$4000 


FWA 


NUM 


$2000 
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Subroutine 



CLRPB 



LOOP 



DONE 

TEMPQ 

TEMPA 









STQ* 


TEMPQ+1 


STA* 


TEMPA+1 


LDA 


=X$7FFF 


SUB* 


(CLRPB) 


RAO* 


CLRPB 


LDQ* 


(CLRPB) 


SOV 





CPB 




INQ 


1 


AAQ 





SOV 


DONE-*-l 


JMP* 


LOOP 


RAO* 


CLRPB 


LDQ 


=NO 


LDA 


=NO 


JMP* 


(CLRPB) 



5.5.2 



y 



5. 5. 3 Instructions EIN and UN 

These instructions are used to either enable the interrupt system or inhibit the 
interrupt system. If the program protect switch on the programmer's panel is 
on, these instructions must be protected. Otherwise, a protect violation will 
occur. The interrupt system is inhibited immediately upon execution of the UN 
instruction. However, for the EIN instruction one free instruction is allowed 
before the interrupt system becomes enabled. 



SUB 



Example: 




MAIN 


RTJ 


SUB 







UN 




EIN 




JMP* 



(SUB) 



Interrupt System inhibited 



This instruction is free, 



This subroutine will operate on any level without interference from any other level 
since the whole subroutine functions with the interrupt system off. Control is 
returned to the main program before the interrupt system is activated through 
use of the one free instruction following the EIN. 
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For example, if an internal interrupt occurred on line 0, P and the overflow indi- 
cator of the interrupted program would have been saved in word of the trap for 
line (location $100). Control would have been transferred to word 1 (location 
$101). If word 1 contained a jump to the Internal Interrupt Processor, that routine 
would be executed. It would determine the cause of interrupt (program protect 
violation or parity error) by using the appropriate instructions (skips). Then the 
routine could exit back to the interrupted program. It would do that by: 



EXI 



00 



The delta in the EXI instruction should be the lower 8 bits of the word trap lo- 
cation for the appropriate line. In this case, the 00 means the trap for line 0, at 
address $100. 



$104 



$100 







jump to proc. 


O 
V 


P 



line 



exit through here 



The EXI instruction (Exit Interrupt State) is used to exit from an interrupt sub- 
routine. It restores the overflow indicator to its previous state, resets P of the 
interrupted program, and enables the interrupt system. 

5. 5. 4 Instructions INP and OUT 

The INP and OUT instructions are used for all input and output operations on the 
1700. They are used to input or output data to or from the A register. They out- 
put function codes to the peripheral equipment from the A register, and they input 
status conditions of the equipment to the A register. The Q register is used to 
address the desired equipment. A brief introduction to I/O using these instructions 
is contained in Chapter 7. 

5. 5. 5 Instructions SLS and NOP 



The SLS or selective stop instruction is dependent upon the positioning of the 
selective stop switch on the programmer's panel. If the selective stop switch is 
up, then the program will stop on this instruction. If the selective stop switch is 
not up, then this instruction is the same as a NOP or No Operation Instruction, 
where the computer simply steps past this instruction without performing any op- 
eration. If the computer stops, program execution will continue by momentarily 
setting the RUN-STEP switch on the programmer's panel to the RUN position. 
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Example: 
START 



LDA 
NOP 
NOP 



=N$1000 



Put in for future expansion 



SLS 



Program stops iststop 

switch is up 
Continues when run switch 

is hit or if stop switch 

is not up. 



Problem: 

The following is a conversion routine which converts a positive or negative hexa- 
decimal number in the A register to the ASCII codes for the decimal number. It 
consists of a CONVRT subroutine and a main program CONTST which was used to 
check it out. 

Study the program carefully, see how the conversion is done and how the param- 
eters are passed. 

This should be considered a final examination over the 1700 instructions and their 
use. 
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0001 








NAM 


CONVRT 


0002 


P0000 
P0001 


0001 
0001 




BSS 


SAVEQ ( 1 ) ♦ SAVEI ( 1 ) • SAVEA ( 1 ) 


0003 


P0002 
P0003 


0001 
0003 


BUF 


BSS 


BUF(3) 


0004 
0005 


P0006 
POOOC 


0006 
002B 


BUF1 
SIGN 


BSS 
NUM 


BUFK6) 
$2B»$2D 


0006 


POOOD 
POOOE 


002D 
0030 


TAB 


NUM 


$30»$31»$32»$33»$34»$35»$36»$37»$38»$39, 




POOOF 
P0010 


0031 
0032 










P0011 
P0012 


0033 
0034 






! 




P0013 
P0014 


0035 
0036 






! 




P0015 
P0016 


0037 
0038 






1 


0007 


P0017 


0039 




ENT 


CONVRT 


0008 
0009 


P0018 
P0019 


0000 
48E6 


CONVRT 



STQ* 


o i 

SAVEQ 1 


0010 
0011 


P001A 
P001B 


EOFF 
48E5 




LDQ- 
STQ* 


I 1 
SAVEI ! 


0012 
0013 


P001C 
P001D 


0842 
40FF 




CLR 
STQ- 


Q i 

I ! 


0014 
0015 


P001E 
P001F 


0122 
0D01 




SAP 
I NO 


POS i 

1 j 


0016 
0017 


P0020 
P0021 


0864 
EAEA 


POS 


TCA 
LDQ* 


A 

SIGN»Q i 


0018 
0019 


P0022 
P0023 


48E8 
E8EA 




STQ* 
LDQ* 


BUF1+5 | 
TAB+O J 


0020 
0021 


P0024 
P0025 


48E1 
EOOO 




STQ* 
LDQ 


BUF1 i 
-N$20 1 


0022 


P0026 
P0027 


0020 
48DF 




STQ* 


BUF1+1 ! 


0023 
0024 


P0028 
P0029 


48DF 
48DF 




STQ* 
STQ* 


BUF1+2 

BUF1+3 ! 


0025 
0026 


P002A 
P002B 


48DF 
0842 


LOOP 


STQ* 
CLR 


BUF1+4 
Q 


0027 
0028 


P002C 
P002D 


0106 
3000 




SAZ 
DVI 


OUT 
=N10 


0029 


P002E 
P002F 


OOOA 
EADE 




LDQ* 


TAB»Q 


0030 
0031 


P0030 
P0031 


49D5 
DOFF 




STQ* 
RAO- 


BUF1»I 

I 


0032 
0033 


P0032 
P0033 


18F8 
40FF 


OUT 


JMP* 
STQ- 


LOOP i 

I j 


0034 
0035 


P0034 
P0035 


0C05 
CADO 


BACK 


ENQ 
LDA* 


5 

BUF1»Q ! 


0036 
0037 


P0036 
P0037 


0FC8 
ODFE 




ALS 
INQ 


8 i 
- 1 I 


0038 
0039 


P0038 
P0039 


8ACD 
69C9 




ADD* 
STA* 


BUF1»Q 
BUF«I 


0040 
0041 


P003A 
P003B 


DOFF 
ODFE 




RAO- 
INQ 


I ! 
-1 


I 
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0042 P003C 0171 


SQM 


DONE 


0043 P003D 18F7 

0044 P003E E8C1 DONE 


JMP* 
LDQ* 


BACK 
SAVEO 


0045 P003F C8C1 

0046 P0O40 60FF 


LDA* 
STA- 


SAVEI 
I 


0047 P0041 C000 

P0042 0003 P 


LDA 


= X8UF 


0048 P0043 1C04 
0049 


JMP* 
END 


(CONVRT) 



I 


OOFF 


SAVEO 


0000P 


SAVEI 


0001P 


SAVEA 


0002P 


BUF 


0003P 


BUF1 
LOOP 


0006P 
002RP 


SIGN 
OUT 


000CP 
0033P 


TAB 
BACK 


OOOEP 
0035P 


CONVRT 
DONE 


0018P 
003EP 


POS 


0021P 









r 



CONTST 2BB5 
CONVPT 2BC8 



TTY 
Output 



< 



PP 

* 

MI 
*p 

J 

*ASSEM 

OPTIONS LX 

J 

*P . 

J 

*L,5 

J 

*X 

+14272 -* 

J 



Answer 



c 
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0001 




NAM 


CONTST 


0002 
0003 




ENT 
EXT 


CONTST 
CONVRT 


0004 P0000 0000 

0005 P0001 COOO 


CONTST 



LDA 



=N$37C0 


P0002 37C0 
0006 P0003 5400 X 




RTJ 


CONVRT 


P0004 7FFF X 
0007 P0005 6800 




STA 


WRITE+6 



0008 



P0006 
P0007 



0007 
54F4 



WRITE 



RTJ- 



0009 
0010 



P0008 
P0009 



0C01 
000F 



NUM 
ADC 



0011 
0012 



P000A 
POOOB 



0000 
18FC 



NUM 
NUM 



0013 
0014 



POOOC 
POOOD 



0003 
0000 



NUM 
ADC 



0015 
0016 



POOOE 
POOOF 



14EA 
0161 



COMPL 



JMP- 
SQP 



($F4) 



-\ 



S0C01 
COMPL 





$18FC > Writes answer 



(SEA) 
EXIT 



0017 P0010 18FF 
0018 


EXIT 


NUM 
EXIT 


SISFF^ 




0018 POOH 54F4 
0018 P0012 OAOO 


0019 




END 


CONTST 



I OOFF CONTST OOOOP WRITE 0007P COMPL OOOFP EXIT 0011P 



CONVRT 0004X 
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5.6 EXERCISES 

5. 6. 1 Exercises - Constant Mode of Addressing 

1. What is in the A and Q registers when location NEXT is reached? 
a) 



NEXT 



b) 



NEXT 



c) 



NEXT 



LDA 


=N$1F0C 




ALS 


3 




LDQ 


=N277 




LRS 


12 




EOR 


=N$0106 




LDA 


=N$7FFF 




LDA 


=N6 




MUI 


=N6 




LDQ 


=AAB 


See Appendix E for 


LDA 


=AXY 


ASCII conversions. 


AND 


=ACD 




LLS 


16 




AND 


=AWZ 





5.6.2 Exercises - Absolute Mode of Addressing 

1. Write code to increase the contents of Index Register I by 10j_g, 



2. If C017 is in core location 3F, and 4016 is in core location 4017, where would 
program control be given for: 

a) 
b) 
c) 



3. What is wrong with these: 

a) 
b) 
c) 



JMP- 


($3F) 


JMP- 


$3F 


JMP+ 


($3F) 


these: 




LDA- 





LDA+ 


$7F3-$700 


LDA+ 


(TEST) 
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5. 6. 3 Exercises - Relative Mode of Addressing 

1. Will these instructions address backward or forward, and how many locations 
from P? 



a) 1831 






b) 1800 






EFFF 






c) 18FE 






What modes 


of address are these 


assembly languag 


a) 


LDA 


TASK 


b) 


JMP- 


($44) 


c) 


RAO+ 


(HIND) 


d) 


STA* 


*+3 


e) 


AND 


=X$4111-4111 


i) 


STQ 


(DRUM) 


g) 


LDA 


=XTWIX 


h) 


LDA- 


10 



3. Why is relative addressing never used to address into the communications region? 



5.6.4 Exercises - Indexing 

1. What is wrong with these: 

a) 
b) 
c) 

2. What number is in A when NEXT is reached: 

Core Location Contents 



LDA 


AB,Q,I 


MUI 


A,Q 


ALS 


6,Q 



0022- 


0000 


0023- 


8024 


0024- 


0023 
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a) 


LDQ 


=N$-1 




LDA- 


($23), Q 


NEXT 








b) 


LDQ 


=N$24 




LDA- 


($22), Q 


NEXT 








c) 


LDQ 


=N$1 




LDA 


$23, Q 


NEXT 








3. What is wrong 


with this program: 

NAM 




START 


LDA 


=N$10 




STA- 


I 




LDA+ 


$2000 


LOOP 


SUB+ 


$2000,1 




LDQ- 


I 




ADQ 


=N-1 




SQZ 


DONE-*-l 




JMP* 


LOOP 



DONE 



5.6.5 Shift and Skip Instructions 



1. What will these machine language 


instructions do: 




a) 0FF0 








b) 01A3 








c) OF52 








d) OF88 








2. What will be 


in the Q and A Registers when this program jumps to OVER. 


Location 


Opcode 


Address 


Comments 


START 


LDA 


=N$738F 


Loads 738F in A 




LDQ 


=N$01CA 


Loads 01CA in Q 




LLS 


3 






QRS 


14 






ALS 


5 






SQM 


GO-*-l 






ARS 


2 






SAM 


GO-*-l 






ALS 


2 






QRS 


3 




GO 


JMP 


OVER 





<-—>■ 
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5. 6. 6 Review Exercises 

1. Switch the contents of Location 1000 into Location 1001, and vice versa: 
TEMP 



LDA+ 


$1000 


STA* 


TEMP 


LDA+ 


$1001 


STA+ 


$1000 


LDA* 


TEMP 


STA+ 


$1001 



Several points of note: 

1. The problem descriptions seldom, if ever, specify core locations in decimal; 
they're assumed to be hexadecimal since rarely is a core location referenced 
decimally. Therefore, 1000 and 1001 in the problem mean 1000 hex and 1001 
hex. 

2. The TEMP location is necessary for switching to hold the one operand while 
the other is being switched. This form TEMP can be used to simply 
define a core location; one cell is reserved and zero's placed therein. 

3. The one-word relative mode of addressing is used for locations within the 
range of .+ 127 to save one core location and one cycle time, and also to allow 
the program to be run anywhere. 

4. Two-word absolute mode of addressing is used for the core locations 1000 & 
1001. This is because this program could be finally loaded any number of 
core locations away from 1000 and 1001; therefore, a two-word instruction 
is needed. But why use absolute mode instead of relative? For programming 
"run anywhere" programs there are two basic rules: 

a) Everything that will move with the program is to be coded using relative 
mode; 

b) Everything that remains fixed in core is to be coded using absolute mode. 

Since the statement of the problem states the two fixed core locations to be 
switched regardless of where the program doing the switching is to be loaded, 
references to 1000 and 1001 should be made using absolute mode. 
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2. Transfer the contents of core locations 1000 through 1FFF to 3000 through 3FFF. 



START 


LDQ 


=X$1FFF-$1000 


LOOP 


LDA+ 


$1000, Q 




STA+ 


$3000, Q 




INQ 


-1 




SQM 


DONE-*-l 




JMP* 


LOOP 



DONE 

3. Do a reverse transfer of problem 2, i.e. 
in 3FFE, etc. 

START 



LOOP 



place contents of 1000 in 3FFF, 1001 



LDQ 
CLR 

STA- 
LDA+ 

STA+ 

DAO_ 


=X$1FFF-$1000 

A 

I 

$1000,1 

$3000, Q 

I 

-1 

DONE-*-l 

LOOP 


INQ 

SQM 

JMP* 



DONE 



For this problem, two index registers are needed, one indexing up (I), and one 
indexing down (Q). 



4. Do Example 2 without Index Registers: 





NAM 


EXAMP 




AREA1 


ADC 







AREA2 


ADC 







COUNT 


NUM 





NUM sets the number 




LDA 


=X$7FFF-$1FFF+$1000 




STA* 


COUNT 






LDA 


=N$1000 


First Address in AREA1 




STA* 


AREA1 






LDA 


=N$3000 


First Address in AREA2 




STA* 


AREA2 




LOOP 


LDA* 


(AREA1) 


Indirect Addressing 




STA* 


(AREA2) 






RAO* 


AREA1 






RAO* 


AREA2 






RAO* 


COUNT 






SOV 


DONE-*-l 






JMP* 


LOOP 





DONE 
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Several points to note: V_. 

1. The number prestored in location COUNT is the difference between the 
largest pos sible positive number 7FFF and the difference between the be- 
ginning and end of the core blocks. If we increase this count by one each time 
through the loop, we will encounter an overflow condition when the count 
changes from 7FFF to 8000. We can then loop through and exit from the loop 
using this preset count. 

2. AREA1 and ARE A2 are preset by using the ADC pseudo-op to 0. Formerly 
the form AREA1 was used to perform the same function. The assembler, 
when encountering a zero in the opcode field, treats it as an ADC pseudo-op 
so both forms are equivalent. 

3. This method of solving the problem is absolutely dependent on the use of in- 
direct addressing since the addresses must be contained and manipulated in 
core cells. 
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6.0 

6.0 INTRODUCTION 

The 1700 has 3 assemblers: 

• Basic assembler, which operates as a stand-alone system in a 4-K computer 

• Utility assembler, which operates under the utility system and requires an 8-K 
computer 

• Macro assembler, which operates under the mass storage operating system and 
requires a 12-K computer 

The standard pseudo ops covered in this chapter are available under all 3 assemblers, 
with the exception of some additional pseudo ops available only under the macro assem- 
bler. These are noted where they are described. 

hi addition to the mnemonics for the machine instructions which we have covered, there 
are certain instructions that are only recognized by the assembler. They are used by the 
assembler itself to control the assembly, control the data, reserve storage, convert 
data, signify beginning and end of assembly and control the output listing. These in- 
structions are called pseudo instructions or pseudo ops. 



6.1 NAM 

O 



The first instruction on any source program must be the pseudo instruction NAM. Its 
use is to signal the assembler when to begin assembly and how to set up its program 
counter for this assembly. Its form is: 

Location Opcode Address Comments 

NAM Name 

If the location field is blank, the assembler will begin assembly with its counter at zero 
and signal to the loader in the object program that this program is program relocatable. 
This provides the ability to have the source program assemble without regard to where 
the program will finally be loaded and run in core. If a hexadecimal number appears in 
the location field, the assembler sets its program counter to that value and assembles 
the program absolutely. When a program of this type becomes loaded, it is 1 oaded be- 
ginning at this absolute address specification, hi the address field of the NAM pseudo op 
will be the program name which is reproduced on the output listing. 
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Example: 

NAM SORT 



This program is assembled program relocatable and can be loaded anywhere into core. 
The name SORT will appear on the output listing. 

$100 NAM INTERRUPT 



This program is assembled absolutely, beginning at 100 hex, and will be loaded into core 
at 100 hex only. 



6.2 END 



The last instruction in the program must be an END pseudo instruction. It marks the 
physical end of the program. The address field may contain an entry point to the pro- 
gram. This is called a named transfer address, and it is the entry point where it is 
desired for execution to begin after the object program is loaded. 

Example: 

NAM SORT 
ENT START 
START 



END START 

6.3 ENT, EXT 

Two pseudo instructions are used to provide communication between programs. They 
are the ENT (entry point) pseudo instruction, and the EXT (external point) pseudo in- 
struction. Those locations internal to a program that are needed in another program 
are declared as entry points to the immediate program. The other program can then 
refer to these entry points in its immediate program by declaring them as external. The 
names must match identically. Since communication between these two programs can 
not be made at assembly time (since both programs can be assembled at different locations 
at different times), the relocating linking loader must provide the correct location ad- 
dresses when these two programs are finally loaded together. To accomplish this, the 
loader builds loader symbol tables (Figure 13) where it places references to all entry 
points and external points. These tables locate exactly for the loader where the entry 
point addresses are and where the external point references are that need patching with 
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their corresponding entry point addresses. When it finds a match in names between an 
entry point and an external point, it does the patching. 

Example: 

Program 1 is written and it needs to extract data from program 8 which has not 
yet been written. The writers of both programs agree to a 10 word area with the 
name of CLARK. Since program 1 needs to refer to CLARK in p r ogr am 8, it de- 
clares CLARK as an external. This external declaration allows the assembler the 
use of this symbol which is not otherwise defined in program 1. 

NAM PROG1 
EXT CLARK 



LDA+ CLARK 

Program 8, when it is finally written, will declare CLARK as an entry point. 

NAM PROG8 

ENT CLARK 

BSS CLARK(IO) 



When both of these programs are finally loaded together in core, the loader will 
link the address of CLARK at program 8 to its correct reference in program 1. 

The EXT described above is called an absolute external. It means references made 
from the program to the external are assembled in absolute form (even if a relative 
mode is used in the instruction). 

More than one symbol can be defined with each ENT and EXT instruction, since their 
general form is: 

EXT n lf n 2 , 

ENT n i> n 2» 

n - name 



r 
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6.4 EXT* 



Another form of external is available under the macro assembler: the relative external. 
It causes the loader (at load time, when linking is done) to patch in the relative distance 
from the referencing instruction to the location of the external, rather than the absolute 
core location. This allows the use of relative references. 



Example: 



E£T : 



TAG 



5800 
7FFFX 



RTJ 



TAG 



A two-word relative mode must be used in referencing these externals. 



6.5 EQU 



It is common to use symbols in place of constants or known address locations. The 
EQU pseudo instruction provides a means of declaring to the assembler the equivalence 
of a symbol with a number or expression. The form of EQU is: 



Location 



Opcode 
EQU 



Address 



Comments 



ONE(l), TWO(2), THREE(3) 



The symbol with its equivalent number is placed in the assembler's symbol directory 
and all references to that symbol will yield its equivalent number. It is important to 
note that the EQU does not generate any code; it simply tells the assembler another value 
for symbols found in the program. For example, it uses a 2 wherever it sees the name 
TWO. 

Example: Count the number of times the exact bit configuration 1110 appears in bit 
positions 4 to 7 of core locations 1000 to 10CE. 





NAM 


FIND 




COUNT 












EQU 


MASK1($00F0), 


MASK2($00E0), FIRST($1000) 




EQU 


LAST($10CE) 




START 


LDQ 


=XLAST-FIRST 




LOOP 


LDA+ 


FIRST, Q 






AND 


=NMASK1 


And out all but bits 4 thru 7. 




EOR 


=NMASK2 


Look for exact match. 




SAN 


OVER-*-l 


Was match not exact ? 




RAO* 


COUNT 


No, match was exact. 


OVER 


INQ 


-1 


Yes, no match. 




SQM 


DONE-*-l 


Finished ? 




JMP* 


LOOP 


No. 


DONE 


- 


- 


Yes. 



r~ 
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By using the EQU, the same general problem with different parameters could be solved 
with this program simply by changing the EQU card. Assume the problem looked for 
10110 2 in bit positions 8 through 12 of core location 3020 through 3F21. Simply pull out 
the EQU card and insert one: 

EQU MASK2($1F00), MASK2($1600), FIRST($3020) 

EQU LAST($3F21) 

The EQU instruction is especially useful for referencing the mask tables in low core. 
(See Appendix I. ) These masks are available for foreground or background programs to 
use, rather than defining additional core locations in a program to contain masks. The 
EQU's to be used would be as follows: 

EQU LPMASK($2), NZERO($12), ZERO($22) 

EQU ONEBIT($23), ZROBIT($33) 

These are the same EQU's used by the system and they make it easier to remember 
which mask is being used. For example: 

LDA- LPMASK+2 
This can be used instead of: 

LDA- $4 

The same code is generated: C004 

It is easier to remember that LPMASK+2 is a mask location containing two one bits on the 
right end than to remember what location $4 contains. NZERO+4 would contain 4 zero 
bits on the right. Location ZERO always contains a word. ONEBIT+5 would contain a 
one bit in bit position 5; ZROBIT+8 would contain a zero bit in bit position 8. 



6.6 NUM 



hi order to insert known constants into the assembly, the pseudo op NUM is used. Its 
form is: 



Location Opcode 


Address 




Comments 


s NUM 


C l' c 2"" 


' C n 




s means a symbol 





16-bit constants are inserted, in line, one constant to a word. If a symbol is specified 
in the location field, it is assigned the storage address of the first constant. 
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Example: 



HERE 



NAM 

NUM 



EXAM 

$7312, 21, -21, -$216 



v.,.- 



Since this is a program relocatable assembly (blank in location field of NAM card), HERE 
is at program counter P0000 and the following constants are inserted: 



P0000- 


7312 


P0001- 


0015 


P0002- 


FFEA 


P0003- 


FDE9 


Expressions are not allowed. 




NUM 


6.7 ADC 





$7312-41 



Illegal 



To insert in line a table of addresses, the ADC pseudo instruction is used. It functions 
identically to the NUM pseudo instruction except expressions may be used and the result 
is evaluated for only 15 bits since an address value cannot exceed 15 bits in length. Bit 
15 will be set if the expression is enclosed in parentheses (indicating an indirect refer- 
ence). Its form is: 



ADC 



J l» c 2 



eg — e 



n 



Example: 



Location 


Opcode 


Address 


Comments 




NAM 
EQU 
EQU 


EXAM 

TEN(IO) 

MASK($F302) 




HAT 


ADC 


TEN 


TEN is 000A (See EQU) 


STILL 


ADC 


(HAT) 


Will set Bit 15 



Assume the program counter for HAT is at P0102 and for STILL, P01FF; then: 
P0102 000A 



P01FF 



8102 



6.8 ADC* 



Under the macro assembler there is a second form of the ADC pseudo op, the ADC* 
pseudo op. This form functions identically to the ADC pseudo op in the utility assembler. 
However, all address expressions evaluated are then placed in relative form. Exam- 
ples of both forms are on the following page. 
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HERE 

HERE which is at P0014 has the absolute address of TAG (P0000), and HERE+1 (P0015) 
has the absolute address of TAG1 (P000A). 



NAM 


EXAM1 


BSS 


TAG(10) ,TAG1(10) 


ADC 


TAG , TAG1 



NAM 


EXAM2 


BSS 


TAG(10) ,TAG1(10) 


ADC* 


TAG , TAG1 



HERE 

HERE, at P0014, has the relative address of TAG (FFEB, or twenty decimal locations 
back) and HERE+1 (P0015) has the relative address of TAG1 (FFF5). 



6.9 ALF 



ASCII characters are stored in consecutive locations, two 8-bit characters for each core 
location, by the ALF pseudo instruction. The ALF pseudo instruction is used to pack a 
core area with a message which can be used for subsequent output to ASCII devices like 
the teletype. A symbol, if used in the location field, will refer to the first word of the 
block. The format for the ALF pseudo instruction is: 

s ALF n, <^2n characters^ 

Example: 

NAM EXAM 

HERE ALF 3,ABACAD 

Three words are packed with the ASCII equivalents of ABAC AD: 



P000O 


4142 


P0001 


4143 


P0002 


4144 



Table of ASCII equivalents is found in Appendix E. 
A blank is stored into unused locations. 
Example: 





HERE 


ALF 


6, ABACAD 


produces: 


P0000 


4142 






P0001 


4143 






P0002 


4144 






P0003 


2020 






P0004 


2020 






P0005 


2020 
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The ALF pseudo op in the utility system only allowed specification for its message by the 
use of an unsigned integer for the number of core locations to be reserved. In the macro 
assembler a second form for this pseudo op is available: 



ALF n, <^message^>n 



n may be a non-integer character which signals the end of the message, n is a delimiter 
and appears before the comma and after the message. 

This form is an advantage where the programmer does not desire to count the number of 
words in his message and will find no conflict between his message and the terminating 
character used. 

For either form the pseudo op ALF will pack two ASCII characters per word. The address 
of the first location of the message in core will be assigned to the symbol in the location 
field, if specified. 



Example: 



NAM EXAMP 

GO ALF Z,DATAZ 



Two words are reserved, starting at location GO for the ASCII equivalent of DATA. 

6.10 DEC 

A DEC pseudo op is available under the macro assembler. Suppose the following problem 
needed to be solved: 

y = 1. 63 x 10 3 x 2 + 21246 x 10" 2 x + 81 x 2 6 
. 0074 x 10 6 .HxlO 3 

Insertion of the constants in this problem would be facilitated by having the assembler do 
the binary or decimal conversions. The DEC pseudo op allows insertion of constants with 
decimal or binary scaling factors. Its form is: 

s DEC k i» k 2* ,,,k n 
k is a constant - fDdBb 

Example: NAM EXAMP 

HERE DEC 163D1, 74D2, 21246D-2, 81B6, 11D1 



This example shows the constants from the equation inserted. The decimal numbers are 
converted mentally to integers. HERE is the symbolic address of the first of these 
decimal constants which are inserted one per core cell. The size, then, of the converted 
decimal constants must lie within the range of ±32, 767. 
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6.11 VFD 



The VFD pseudo op is available under the macro assembler. It is frequently desirable 
to pack data into memory locations. The VFD (variable field definition) pseudo instruc- 
tion assigns data to consecutive locations in the instruction sequence without regard for 
computer words. Data is stored in bit strings rather than word units. Its format is: 

s VFD m i n i /v i' m 2 n 2 /v 2*'-" m n n n /V n 

m will specify the mode. Three modes are possible: 

N numeric constant 

A ASCII character code 

X expression 

n will specify the number of bits and v is the value, n may be 16 bits or less for either 
N mode or X mode; however, for A mode n must be some multiple of 8 since ASCII 
character conversion is meaningless for a non-multiple of 8 bits. Numeric constants 
must be within the range of +32, 767. 

Example using numeric constants: 

NAM EXAMP 

TAG VFD N4/$F, N8/6, N8/-6, N2/16 

LDA 



The assembly of the bit strings begins with the high order bit of the first core cell (in 
this example the core cell labeled TAG). TAG gets packed with 1111 which is the binary 
equivalent of hexadecimal F. The next 8 bits of TAG get packed with the binary equivalent 
of 6 which is 0000 0110. The next 8 bits (which will now be the lower four bits of TAG) and 
the upper four bits of TAG+1 get packed with -6 or 1111 1001. The next two higher order 
bits get packed with as much of the number 16 as is possible, that is, with the low order 
two bits (00). The remaining bits of TAG+1 set to zeros. TAG and TAG+1 will then look 
like this: 



TAG 


F06F- 


1111 0000 0110 1111 


TAG+1 


9000- 


1001 0000 0000 0000 



If the number of bits specified is not sufficient for the value then the high order bits of 
the value are truncated (chopped off), as many as are necessary. If the number of bits is 
larger than the value, then the sign of the value is extended. 

Example using expressions: 

NAM EXAMP 

EQU TAG($4FF1), HAT(20) 

TOP VFD X8/TAG+2,X8/HAT 
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The previous example shows the use of expressions where the expression is evaluated 
absolutely (since neither TAG nor HAT is relocatable). If fewer than 16 bits are spec- 
ified, the absolute expression by itself is evaluated (using 16 bits) and is truncated. The 
previous example is decoded by the assembler. 

TOP F314 

When the expression is evaluated relatively, the n must be 15 and the expression must 
be positioned so that it will be stored right justified at bit position of the computer word. 

Example using ASCII character mode: 

NAM EXAMP 

TAP VFD A24/ABC, N8/$3F 

The above example illustrates three ASCII characters, A, B and C; these will be con- 
verted using 8 bits for each, followed by the numeric constant 3F hex in the lower 8 bits 
of TAP+1. The above example is decoded by the assembler. 





TAP 


4142 




TAP+1 


433F 


6.12 BSS, BZS 







Blocks of data storage can be all ocated within the program using either the BSS or the 
BZS pseudo instructions. The block is given a name and a size according to the following 
format: 

BSS n. (s.),n (s ), n (s ) 

V 1' 2 V 2' m nr 

n is name of block 
s is size 

These pseudo instructions reserve areas. The BZS area is zeroed out at load time 
while the BSS block is not changed at load time; therefore, anything may be initially set 
in a BSS block at run time. 

Example: 



NAM 


EXAM 


BSS 


AA(10), BB(20) 


LDA 


- 



The symbol AA will be assigned the address of the first location of the block of 10 and 
the symbol BB will be assigned the address of the first location of the block of 20 loca- 
tions reserved. When this program is loaded, anything can be initially contained in these 
first 30 locations. Had a BZS been used instead of the BSS, these first 30 locations would 
have been zeroed at load time. 
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6.13 DAT, COM 



Two other pseudo ops are used to reserve areas for use that are outside the bounds of 
the main program. These areas are reserved by the DAT and COM pseudo ops. Refer 
to Figure 13. Notice that the common storage area (reserved by the COM pseudo instruc- 
tion) is the area that is used by the loader. This area cannot be preset with data and 
is used only at run time when the loader becomes destroyed. The data area (reserved by 
the DAT pseudo instruction) is assigned an area with the programs themselves; in fact, 
the data block will precede the program that declares it. The data area can be preset. 
The loader will make common and data area assignments just once and will use its com- 
mon counter and data counter at this assigned value for the rest of the programs loaded. 
It is necessary, then, for the first subprograms of a run declaring common or data 
storage to declare the largest amount necessary. The format for the COM and DAT 
pseudo instructions is the same as for the BSS and BZS and is: 



O 



Example: 



DAT 
COM 



NAM 
BSS 
DAT 
COM 



n 1 (s 1 ),n 2 (s 2 ),...n m( s m ) 
n 1 (s 1 ),n 2 (s 2 ),...n m (s m ) 



EXAM 

AA(30) 

CAT (40) ,RAN(20) 

CCC(40) ,AB(10) 



The BSS will reserve 30 locations within the program while the DAT will reserve a total 
of 60 core locations, reserved outside of the program area, hi fact, this data area will 
immediately precede the main program area in core. The common area, 50 words in 
this example, is reserved at the high end of core where the loader resides at load time. 
This common area cannot be preset with data and can only be used at run time, when the 
loader is no longer needed. 



v„^ 
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High 
Core 



013F 



0100 * 

00FF ► 



0000 



Loader 












Loader Symbol Tables 








More Programs 
A 




Program 








Data 






t 






Executive Monitor 
Resident 




Interrupt 
Area 




C ommunication 
Area 





V 



50 Words 
Common Counter 



Program Counter 
60 Words 
Data Counter 



C 



Figure 13. Data, Program and Common Counters. 

Figure 13 illustrates the three counters: data, program and common counter. There 
are three types of relocation possible when loading programs, each type using its 
appropriate counter. References to addresses will be relocated using the data counter if 
the address is in the data area, the program counter if the address is in the main program 
area and the common counter if the address is in the common area. 
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Example: 



NAM 


exam: 


DAT 


AA(10) 


COM 


BB(10) 


BSS 


CC(10) 


LDA+ 


AA+3 


STA+ 


BB+7 


STA+ 


CC+4 



The listing for the above looks like: 
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001. 






NAM 


EXAMP 


002. 




0000D 


DAT 


AA(10) 


003. 




OOOOC 


COM 


BB(10) 


004. 


P0000 


000A 


BSS 


CC(10) 


005. 


POOOA 
POOOB 


C400 
0003D 


LDA+ 


AA+3 


006. 


POOOC 
POOOD 


6400 
0007C 


STA+ 


BB+7 


007. 


POOOE 
POOOF 


6400 
0004P 


STA+ 


CC+4 



The first column is the line number. The second column is the core location in hex. 
The P preceding it indicates that the value of the program counter will be added to the 
number at load time, yielding the actual core location. 

Hex word followed by relocation symbol: P for program counter, D for data counter, and 
C for common counter. 

Although there is only one common area and one data area assigned per core load, refer- 
ences to data in these areas can be made by all programs in core. The relative position 
with respect to the data or common counter for the data desired must be known by each 
program but the same names need not be used by different programs to reference the 
same data. 

Example: Program 1 is the first program loaded. It must declare the largest data or 
common area. 



NAM 
DAT 



PROG1 

AX(100) , BX(50) , CX(100) 
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When the program is loaded, a data area of 250 locations is assigned and the data counter ( 
is set at the beginning of this area. 

Suppose PROG6, which is the sixth program loaded, is interested only in the data which 
PROG1 knows as the 26th to 30th locations in BX. 



NAM 
DAT 

LDA 



PROG6 

DUMMY(125), MINE (5) 

MINE 



DUMMY is not used by program 6. It only allows a skip past the AX and first 25 locations 
of BX corresponding to program 1. Reference to MINE in program 6 will yield the 
same data as reference to BX+25 in program 1. 

6.14 ORG, ORG* 

Presetting the data area is accomplished by the use of the ORG pseudo op. Its form is: 

ORG a 

This pseudo op changes the value of the assembler's counter to agree with a. All in- 
structions or data following the ORG instruction are assembled into consecutive locations 
until either another ORG instruction is encountered or an ORG* is encountered. When 
an ORG* is encountered, the assembler's program counter is set to the value that it 
would have been if the very first ORG instruction had not occurred. The address ex- 
pression (a) may be either positive program relocatable, positive data relocatable or 
absolute. Notice common relocatable address expressions are not allowed since the 
common area cannot be preset. 



Example: 



NAM 
DAT 
LDA 



EXAMP 
AX(20) , BX(40) 



ORG 



Assume P. C.=P0030 



AX+10 



ORG 


AX 


BZS 


10 


ORG* 


-■■•-'- -J~ "" 


LDA 


- 
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In this example the program counter starts off at 0000 and proceeds in sequence until 
the first ORG instruction is assembled. Since the address expression refers to the data 
area, the assembler's program counter will now be at D000A, indicating that the code 
beneath this first ORG pseudo instruction will be inserted beginning in the 10th data area 
location. When the second ORG instruction is encountered, the code under it (BZS10) is 
assembled into the beginning of the data area. When the ORG* instruction is encountered, 
the program counter is set to P0031; this is the next location following the last location 
assembled before the first ORG instruction. Any symbols used in the address expression 
of the ORG pseudo op must have been previously defined in the program. 

The following example can be used to illustrate presetting values in A and B in the DATA 
block: i* 

AE 0000D 
XE 0000C 
CE 0007D 

0000P START 

0001P 

0002P 

0000D 



0004P 



DAT 


A(5) ,B(2) 


COM 


X 


DAT 


C(50) 








LDA- 


$FF 


STA+ 


X 


ORG 


A 


NUM 


1,2^3^4^ 6, 7 




A B 


ORG* 




RAO- 


$FF 



6.15 IFA, EIF 



n 



The macro assembler contains a conditional assembly instruction. With the pseudo op 
IFA, it is possible to specify portions of a program to be either assembled or excluded 
during assembly time. Its format is: 



IFA 



e l' C ' e 2 



(This pseudo op can be used within a macro skeleton. ) e may be an expression and c 
specifies one of four conditions: 



EQ 


e l= e 2 


NE 


e^e 2 


GT 


e l> e 2 


LT 


e l< e 2 



The termination of the coding encompassed within the range of an IFA pseudo op is 
accomplished with the pseudo op EIF. Since nesting is allowed, a match between an IFA 
and EIF pseudo op range is made by correspondence between the first two characters of 
the symbols in the location field of the IFA and the address field of an EIF. 
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Example: 



TOTS 



NAM 


EXAMP 


EQU 


AB(10) ,AC(20) ,AD(30) 


IFA 


AB+AC,EQ,AD 


LDA 


TAG 


STA 


TAG1 


EIF 


TOTS 



The LDA TAG and the STA TAG1 instructions will be assembled in this example since 
equality exists. Changing the EQU card, however, or changing the condition from EQ to 
NE would have excluded these two lines of code from the assembly. 

Problem: 

VALUE PROBLEM (COMMON) 

Starting in the 11th location of COMMON are 10 words. Bits 13-8 of each of the 10 words 
are to be compared with bits 5-0 of a location called VALUE which is external to this 
program. Do not destroy the original contents of VALUE. Count how many complete 
matches are found in the bit strings compared and store the answer in the 7th word of the 
data block. For example, if bits 5-0 of VALUE contain 101100 and bits 13-8 of X 1 
c on tain 101100, one match has been found. Any other bit configuration would be a no- 
match. Write a complete program to solve this problem. 



Xi 



Value 




6.16 MAC, EMC 

The macro assembler gets its name from the macro capability incorporated therein. An 
often used set of instructions may be grouped together to form a macro. Macros then 
need be defined once and thereafter the whole macro structure will be incorporated in 
line in the assembly generated coding whenever the macro name is called. Each macro 
has a name which is first defined by the use of the MAC pseudo op and thereafter the 
name can be placed in the opcode field as if it were an instruction or pseudo instruction 
and the assembler will substitute, starting at that location, the whole structure that was 
previously defined by that name. The macro must first be defined. The form is: 



MAC 



^.Pg P. 



n 



6-16 



6.16 

s is the name of the macro. The p f s are symbols of one or two characters that will de- 
fine variables within the macro structure. Parameters are enclosed in apostrophes as 
shown within the macro. The keypunch code for apostrophe is 8-5. The macro structure 
itself is defined to be finished when the EMC pseudo op appears in the opcode field. EMC 
is always the last instruction in a macro definition. 



Example: 




NAM 


EXAMP 




HELP 


MAC 


XA,XB 






LDA 


'XA' 






STA 


'XA'+l 






ADD 


'XA'-l 






STA. 


'XB' 






EMC 





HELP is the name of the macro and XA and XB signify variables within the macro. All 
the code between the MAC and EMC is the macro structure. Anything in this structure 
can be made variable. In this assembly only positions of the address field were varied. 
Macros canbe of any length and they can also be nested. A macro must be defined before 
it is called by name. Calling the macro in the above example would look like this: 



SAZ OVER-*-l 

HELP TAG,TAG1 

OVER 



The macro is called by placing its name in the opcode field. The assembler will search 
the symbol directory for a macro with the name of HELP, and if found, the complete 
macro structure is placed in line at this point. When calling a macro, the variables must 
be specified. For this example TAG will be inserted for each XA reference and TAG1 will 
be inserted for each XB reference. Effectively, then, the assembler will place in line 
the following: 



STA 


TAG+1 


ADD 


TAG-1 


STA 


TAG1 



A macro could be defined as "an instruction which 'stands for f a number of other instruc- 
tions. " 
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6.17 LOC 



Since the code for a macro is inserted in line wherever it is "called," if there are any 
symbols in the location field of the macro, it could be called only once, since the symbol 
would-be doubly defined if the macro were called again. This problem can be eliminated 
by defining the symbols local to the macro. 

Symbols that are local to the macro being defined are listed in the LOC pseudo op. This 
pseudo op immediately follows the MAC pseudo op and it allows use of one- or two- 
character symbols local to the macro so that the same symbols can also appear in the 
main program. Its form is: 



Example: 





LOC 


S l ,S 2'" ,,,S n 




NAM 


EXAMP 


TOPP 


MAC 


AD,AB 




LOC 


Gl, G2 




LDA 


! AD T 


T AB' 


EOR 


=N$0171 


f Gl» 


STA 


f AD T +l 


'G2' 


JMP 

EMC 


! AD T +2 



Symbols passed as parameters may not be defined as local. 



6.18 IFC 



A conditional assembly pseudo op is available for use within the macro skeleton. It is 
the IFC pseudo op. It operates the same as the IFA covered previously; however, it has 
only two conditions, the NE and EQ. Its form is: 



IFC 



a i' C ' a 2 



Each a must be a string of from one to six characters, or a formal parameter specified 
in the MAC statement. The character strings should not contain commas, blanks or 
apostrophies. Two character strings are equal when they contain the same characters in 
the same position and are of the same length. Characters in excess of 6 are ignored. 
Termination of the range of the IFC is made when an EIF is encountered with the first 
two characters of the symbol in its address field matching the first two characters in the 
location field of the IFC. 
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Example: 



TOTAL 



IT 



NAM 


EXAMP 


MAC 


XA,XB,XC,XD 


LD'XA' 


=N$4000 


STA 


'XB' 


IFC 


'XC'EQ'XD' 


ADD 


'XB'+2 


STA 


'XB' 


EIF 


IT 


EMC 





If parameter XC and XD are equal when this macro is called then the ADD and STA in- 
structions will be incorporated in line with the rest of the macro structure. If para- 
meters XC and XD are not equal when the macro is called, these instructions will 
not be inserted in line as part of this macro structure during assembly. 



TOTAL 



Q, TAG, TEN, NINE 



o 



The generated code is: 



LDQ 

STA 



=N$4000 
TAG 



Since TEN and NINE do not match character for character, the IFC condition is not met 
and the ADD followed by the STA instructions are not assembled. 

Problem: 

Write a macro for an INI instruction. Add a test routine to check it out. 

The INI macro s hould increase the I Register by any constant exactly the same way the 
INA increases the A Register or the INQ increases the Q Register, hi other words, no 
other registers should be destroyed when the macro is called. 

6.19 NLS, LST, SPC 

Three pseudo instructions are used for control of the listing. They are NLS, which pre- 
vents normal output list until a LST instruction is encountered or until the end of a 
program. Spacing paper on the printer is accomplished by the SPC pseudo op. The 
number of lines to space is specified as an absolute address expression in the address 
field. 



•^ — > 
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Example: 



NAM 


EXAMP 




/"' 


LDA 


- 




'V 


SPC 


12 


12 lines are spaced 




NLS 




Listing is stopped 




LST 


— 


Listing is enabled 





6.20 EJT 



In addition to the NLS, LST, and SPC listing control pseudo in s tr uc ti on s, the macro 
assembler also has an EJT pseudo op. This ins truction causes page ejection during 
printing of the list output. 



6.21 OPT 



Three standard options determine the type of output from the assembler. All three are 
automatically selected if no OPT statement is encountered before the first NAM. OPT 
is the only pseudo instruction that may precede the NAM pseudo op. No code is generated 
by this pseudo instruction. 

OPT must begin in card column 2. 

Normal execution of assembly produces list output on the standard list device, punch 
output on standard punch device and load and go output on the mass storage device. These 
are options L, P and X. Two other options are available. The M option will enable 
listing of macro skeletons and an A option will cause abandonment of the assembly and 
will return control to the operating system. To exercise these options or to eliminate 
any of the three standard options, the OPT pseudo instruction is used. When the OPT 
pseudo instruction is encountered by the assembler it will type OPTIONS on the tele- 
typewriter and allow the operator to manually reset the options desired. He can choose 
any or all of these five options. 

Option Meaning 

L List output on standard list unit 

P Punch binary output on standard punch unit 

X Load and go; executable output loaded on a mass storage 

device 

M List macro skeletons 

A Abandon assembly 
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Relocatable binary output is selected by the P option. 
1700 Operating System Reference Manual. 
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The format is described in the 



If the X option is selected, relocatable binary output is placed on the mass storage unit 
for subsequent loading and execution as described in the 1700 Operating System Reference 
Manual. 

The L option results in assembly listing. 



6.22 MON 



After the last subprogram has been assembled, control can be returned to the operating 
system by use of the MON pseudo op. It may be used only after the END statement. 

MON must begin in card column 2. 

Example: 

cc 

2 

OPT 



NAM 



PGM 



O 



MON 

cc 

2 



END 

NAM 



END 



n «*- 
SUB 



Name of main entry point in main 
program 

No name on subroutine end card 



6.23 EXERCISES ON PSEUDO OPS - UTILITY ASSEMBLER 
1. What are the errors in this program ? 
Location 



LED 
TAG 
TAG11 

START 



Opcode 


Address 


Comments 


NAM 


EXAMP 




EQU 


720 




NUM 


-72,$FFFF,72 




BSS 


25 




EXT 


LAD, TAG 




LDA+ 


TAG 




STA+ 


LAD 





END 



START 
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2. Why will the ORG LIST produce an error ? 

COM LIST(30) 

ORG LIST 



3. In this example: 

COM LIST(30) 



LDA LIST 

this assembler will decode the LDA LIST as: 

C400 
0000C 
Why? 



4. What is the problem ? 



BSS LIST (10) 



LDA LIST+3 

SAZ 



6. 24 EXERCISES ON PSEUDO OPS - MACRO ASSEMBLER 
1. What code is produced: 

a) VFD N12/-17 , N5/$7F2 , N15/47 

b) VFD A8/A,A8/B 

c) DEC 16D1B4 

d) ADC* *-l 
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2. What instructions are assembled: 





EQU 


AA(10),BB(20),CC(30) 


GOl 


IFA 


10,GT,BB-15 




LDA 


=N$1000 


T02 


IFA 


CC-AA, EQ,BB 




ADD 


=N$1000 


H03 


IFA 


40, NE, BB*2 




ADD 


=N$2000 




EIF 


HO 




EIF 


TO 




EIF 


GO 



3. If this macro definition: 



PRINT 


MAC 


XA,XB,XC 


TAG 


ALF 


Z,ERROR'XB T Z 




IFC 


'XA',EQ,LU 


TAG1 


ALF 

EIF 

EMC 


Z, LOGICAL UNIT'XC'Z 


is called by 







PRINT 



LU, 6, 8 



what assembly language is produced when this macro is called ? 
4. What discrepancy is in this program ? 



FALL 


MAC 






LOC 


TE 


'TE' 


NUM 


$7FF3 




LDA 


t TE r 




EMC 






FALL 






LDA 


TE 



u. 
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7.0 



7.0 INTRODUCTION 



The 1700 is composed of a 1704 and various peripherals. The 1704 contains the regis- 
ters and the logic necessary for bringing data into the computer, performing operations 
upon the data and sending the data out of the computer for future reference and/or dis- 
play. 



INPUT 



CONTROL 



ARITHMETIC 



MEMORY 



OUTPUT. 



1704 



The peripherals are composed of devices capable of sending and/or receiving data. 
Such devices are the teletype, paper tape reader and paper tape punch. Many other 
peripherals are available and discussed in Chapters 12 and 14. 

The peripherals and the 1704 cannot communicate directly; therefore, an interpreter 
is required. The interpreter is referred to as a controller. The program tells the con- 
troller the operation to be performed and the controller directs the peripheral in the 
performance of the operation. 

7. 1 UNBUFFERED I/O 

7. 1. 1 Use of Registers in I/O 



Communications among the 1704 and the peripherals is accomplished via one 
input/ output (I/O) channel attached to each controller. The I/O channel works in 
conjunction with the 1704's A register and Q register. It is, consequently, called 
the A/Q channel. 



1704 





A/Q 


TTY 














PTR 












PTP 
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7.1.1.1 

7. 1. 1. 1 Q Register 



The Q register designates the equipment to be referenced and directs the op- 
erations to be performed. The Qregister will be in the following format when 
performing an I/O operation via the A/Q channel. 

15 11 10 An 7 6 I 

Q 



W 



E 



D 



The W field , bits 15-11, will always be zero except when referencing a 1706; 
this will be discussed later. 

The E portion, bits 10-7, designates the equipment number being referenced. 
The equipment number will correspond directly with a hardware switch located on 
each controller. The number will vary from a hexadecimal to a hexadecimal 
F. 

The Sportion distinguishes among peripherals attached to the same controller. 
The bits composing the station code will vary with controllers. 

The D portion is the director bit or bits which designates the type of information 
being transferred: data, status or function. The number of bits used to com- 
pose the D portion also varies according to the controller being referenced. 

7. 1. 1. 2 A Register 

The A register sends and receives all communications between the 1704 and 
the peripherals; that is, the data, functions, or status. 

7. 1. 2 Functions, Status, and Data 

The 1704 is capable of sending or receiving data, sending a function, or receiving 
status. The D portion of Q and the I/O instruction executed denote which of 
the three operations is to be performed. All input/ output operations via the A/Q 
channel are performed with two instructions. 

INP - 
OUT 

The INP instruction brings information into the A register: data or status. 
The OUT instruction sends information from the A register: data or function. 
Bit of Q is usually the D portion, designating the type of information being 
transferred. (Note: the exceptions are discussed in Chapter 14. ) When bit 
of Q is a 0, the transfer of data is designated. The direction of the data flow is 
indicated by the I/O instruction. The INP brings data into A. The OUT sends 
data from A. When bit of Q is a 1, the transfer of status or the transfer of a 
function is requested. INP requests status while an OUT sends a function. 
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INP 



OUT 



D = data 
•D = 1 status 
D = data 
\D = 1 function 



7. 1. 3 Summary, Unbuffered I/O 

In review, all input/ output operations performed by the 1704 will take place via 
the A/Q channel. The Q register indicates the peripheral being referenced and 
the type of information being transferred. The information to be transferred will 
be brought into or sent from the A register, depending upon the instruction exe- 
cuted: INP or OUT. Three types of information may be transferred: data, 
function, or status. 

7.1.4 Low- speed Package 

The grouping of the teletype, paper tape reader and paper tape punch is referred 
to as the low-speed package. The low-speed package is always equipment number 
1. The various peripherals attached are referenced specifically with the S por- 
tion of the Q register, bits 4-6. 



Peripheral 

Teletypewriter 
Paper tape reader 
Paper tape punch 



M S M tation 

1 
2 

4 



The format of Q for each of the low-speed peripherals is as follows: 



15 



11 10 



Q 











D 



v — 

Equip. 

1 



_A_ 



— V 

Station 



TELETYPEWRITER $0090/$0091 





15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 





Q 


























1 





1 














D 




o 



PAPER TAPE READER $00A0/$00A1 
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Q 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 





























1 


1 

















D 



— v 

Equip. 

1 



J\. 



v 

Station 



V. 



PAPER TAPE PUNCH $00C0/$00C1 

The programmer must load the Q register with the correct equipment, station 
and director setting prior to executing the desired I/O instruction. 

The coding necessary to reference each of the low-speed peripherals for data is 
as follows: 



LDQ 
NOP 

INP 

LDQ 
LDA 
NOP 
OUT 

LDQ 
NOP 
INP 

LDQ 
LDA 
NOP 
OUT 



=N$0090 



TTY FOR DATA 



-1 


DATA IN A 


=N$0090 


TTY FOR DATA 


DATA 


DATA IN A 


-1 


SEND DATA TO TTY 


=N$00A0 


PTRDATA 


-1 


DATA IN A 


=N$00C0 


PTP DATA 


DATA 


DATA IN A 


-1 


DATA TO PTP 



7. 1. 5 Reply or Reject 

Control will be returned to the program after the execution of an I/O instruction 
at one of three locations: P+l, P+A, P+l+A. Control will be returned to P+l 
when the controller accepts the command, NORMAL REPLY. Control will be 
returned to P+l+A when the controller rejects the command, EXTERNAL REJECT. 
If the controller fails to reply or reject within 6 microseconds, an INTERNAL 
REJECT is generated and control continues at P+A. The NOP instruction is 
inserted within the above coding to allow for an INTERNAL REJECT. 
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RESPONSE 

INTERNAL REJECT ■ 
EXTERNAL REJECT 
NORMAL REPLY 



ADDRESS 



— »-2000 
(P) 2001 
-** 2002 



INSTRUCTION 

NOP 

INP 

Continue 



A 



-1 



INTERNAL REJECT P+ A 

EXTERNAL REJECT P+1+ A 

NORMAL REPLY P+l 



2001+(-l)=2000 

2001+l+(-l)=2001 

2001+1=2002 



7. 1. 6 Functions 



I/O programming for the 1700 peripherals requires the programmer to connect 
with the desired peripheral by setting the Q register and issuing a function. 



PTR FOR FUNC OR STATUS 
FUNCTION IN A 

SEND FUNCTION TO PTR 



LDQ 


=N$00A1 


LDA 


FUNC 


NOP 




OUT 


-1 



A function is a command or a group of c ommands sent to the controller. The 
function sent will vary according to the equipment. The paper tape reader allows 
the programmer to clear the controller, clear interrupts , select interrupt 
on data and/or alarm, start motion and stop motion. Each function corres- 
ponds to a bit in the A register. The function is requested if a 1 appears in 
the corresponding bit. 



A 



15 
















7 


6 


5 


4 3 2 


1 
































1 


1 1 


i ^ i 


1 


1 



J t 



STOP MOTIO 

START MOTION 
INTERRUPT ON ALARM 

DATA INTERRUPT REQUEST 

CLR INTERRUPTS 

CLR CONTROLLER 

The above functions may be sent together, with the exception of the clear con- 
troller and clear interrupt; these must be sent separately. 

7. 1. 6. 1 Paper Tape Reader Example 

The programmer may clear the controller to clear all logic and interrupts pre- 
viously selected by loading Q with $00A1, by setting bit of the A register and by 
issuing an OUT instruction. 
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LDQ 


=N$00A1 


PTR FUNC OR STATUS 


ENA 


1 


CLR CONTROLLER 


OUT 


-1 


FUNC TO PTR 



The programmer may then start the motor on the paper tape reader. The start 
motor command causes the reader to begin moving paper tape and start reading. 



LDQ 


=N$00A1 


PTR FUNC OR STATUS 


ENA 


$20 


START MOTION 


OUT 


-1 


FUNC TO PTR 



The next step is to bring the data into the A register by setting the director bit 
of Q to and issuing an INP instruction. 



LDQ 


=N$00A0 


PTR FOR DATA 


NOP 






INP 


-1 


DATA INTO A 



The program will continue to loop on the INP instruction until data has been read 
into the holding register of the paper tape reader. Once data is available it will 
be brought into the lower 8 bits of the A register. Note: the number of bits 
composing a data word will vary among the peripherals. The first frame will be 
in A and may be shifted to the upper 8 bits. Input will then be requested again 
for the lower 8 bits. 

ALS 8 FIRST FRAME UPPER 8 BITS A 

NOP 

INP -1 NEXT FRAME BROUGHT TO A 

The entire 16-bit word is now in the A register and should be stored in the 
buffer area. Once the word is stored the program continues to bring data into 
the A register. A check should be made to determine when all requested words 
have been read from the reader. 



v_- 
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NAM 


PTR 




START 


LDQ 


=N$00A1 


PTR FOR FUNC/STATUS 




ENA 


1 


CLR CONTROLLER 




OUT 


-1 


FUNC TO PTR 




ENA 


$20 


START MOTOR 




OUT 


-1 


FUNC TO PTR 




INQ 


-1 


PTR FOR DATA 




NOP 






DATA 


INP 


-1 


FRAME IN A 




ALS 


8 


DATA UPPER 8 BITS 




NOP 








INP 


-1 


16-BIT WORD IN A 




STA* 


BUF 


SAVE IN MEMORY 




LDA 


WDCK 


WORD CHECK IN A 




SAP 


COMP 


WHEN POSnWE COMPLETE 




RAO* 


WDCK 






JMP* 


DATA 


CONTINUE READING 


COMP 


SLS 





STOP WHEN COMPLETE 


WDCK 


NUM 


^FFO 


CHECK FOR 16 WORDS 




END 


START 





o 



The programmer may check for leader on the paper tape as has been done in the 
example on the next page. 



V-' 
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1721 PTR - AUG '68 
USDA 

*Clear controller from console; cannot start motion and clear controller in same 
function. 



01. 








NAM 


BOOTSTRAP 


02. 








ENT 


START 


03. 


P0000 
P0001 


E000 
00A1 


START 


LDQ 


=N$A1 


04. 


P0002 


0A20 




ENA 


$20 


05. 


P0003 


03FE 




OUT 


-1 


06. 


P0004 


ODFE 




INQ 


-1 


07. 


P0005 


0B00 




NOP 




08. 


P0006 


02FE 


LOAD1 


INP 


-1 


09. 


P0007 


0113 




SAN 


3 


10. 


P0008 


18FD 




JMP* 


LOAD1 


11. 


P0009 


0B00 




NOP 




12. 


P000A 


02FE 


LOAD2 


INP 


-1 


13. 


P000B 


0FC8 




ALS 


8 


14. 


P000C 


0B00 




NOP 




15. 


P000D 


02FE 




INP 


-1 


16. 


P000E 


6C04 




STA* 


(ADDRES) 


17. 


P000F 


0103 




SAZ 


EXIT-*-l 


18. 


P0010 


D802 




RAO* 


ADDRES 


19. 


POOH 


18F8 




JMP* 


LOAD2 


20. 


P0012 


0014 P 


ADDRES 


ADC 


*+2 


21. 


P0013 


0000 


EXIT 


NUM 


$0 


22. 








END 


START 


I 
EXIT 


OOFF 
0013P 


START 0000P 


LOAD1 


0006P LOAD2 


^OOTST 
JbS 


1725 


Where 
/ BOOTSTRAP 
loaded 


Set Stop swit 
after reading 
PGM will exe 



PTR DIR FUNC 
START MOTION* 

SET TO READ 

INPUT LEADER 



INPUT FRAME 
SHIFT TO PACK 

INPUT NEXT FRAME 
STORE WORD 
EXIT ON ZERO WORD 
UPDATE ADDRESS 
GO GET NEXT WORD 
LOAD AT P0014 
ZERO FOR SLS 



000AP ADDRES 



0012P 
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7.1.7 Status 



The paper tape reader has been programmed without the use of interrupts for 
each of the above examples. Status may be taken on the paper tape reader at any 
time to monitor the progress of the operation or to assure the program that the 
operation was completed correctly. Status is taken by setting the Q register 
and issuing an INP instruction. 



LDQ 


=N$00A1 


PTR FUNC/STATUS 


NOP 






INP 


-1 


STATUS TO A 



The status is now in the A register. The status conditions exist if a 1 is present 
in the corresponding bit position. 



O 



15 11 10 9876543210 





power or \ a n iL a 

PAPER MOTION FAILURE 

EXISTENCE CODE 

PROTECTED 

LOST DATA 

ALARM 



DATA 
INTERRUPT 



BUSY 

READY 



Ready (bit 0): Power is on and paper tape has been loaded into the reader. The 
preparations have been made known to the logic by pressing the READY switch on 
the paper tape reader console. The reader becomes not ready if a paper motion 
failure occurs or if the power is turned off. 

Busy (bit 1): The paper tape reader is busy if a start motion command has been 
issued and no stop motion command has followed. Motion stops on a stop motion 
command, a paper motion failure, or if the power is turned off. 

Interrupt (bit 2): An interrupt condition exists. Other status bits must be ex- 
amined to determine the condition causing this interrupt. 

Data (bit 3); The data hold register in the paper tape reader contains an 8 -bit 
frame of data which is ready for transfer to the computer. Start motion must be 
set to receive this status. The status drops when the data hold register is 
emptied by transfer to the computer. 



^ 
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Alarm (bit 5): At least one of the following conditions exists in the paper tape 
reader: (1) paper motion failure (bit A9), (2) lost data (bit 6), or (3) power off 
(bit A10 is 0). 

Lost data (bit 6): When in interrupt on data mode, paper motion continues after 
the data hold register is full. If the data is not transferred to the computer 
before the next frame appears, a lost data status occurs to show a frame has 
been passed. The time between frames is 2.857 milliseconds. The status drops 
when a clear controller command is sent. Lost data stops tape motion. 

Protected (bit 7): The PROGRAM PROTECT switch is on. This switch on the 
paper tape reader works in conjunction with the PROGRAM PROTECT switch on 
the computer. If the switch on the computer is off and the PROGRAM PROTECT 
switch of the peripheral device is on, no action is taken but the status bit is set to 
indicate the switch is on. If the switch on the computer is set, all rules of pro- 
gram protection apply. The paper tape reader in this condition only accepts 
protected instructions. 

Existence code (bit 8): The paper tape reader is attached. If the bit is a 1, 
the reader is missing from the particular computer system. 

Paper motion failure (bit 9): No change in the feed hole circuit has occurred for 
40 milliseconds while trying to read. The paper motion failure causes the reader 
to become not ready; it can only be made ready by pushing the READY switch or 
by a clear controller command. It is considered an illegal operation to send 
any other function code or a read command to the reader until the READY switch 
has been pressed or a clear controller has been issued. 

Power on (bit 10): Power to the reader is on. If this bit is a 0, power is off. 



7. 1. 8 Interrupts 



The paper tape reader may be programmed with interrupts by simply selecting 
the desired interrupts and exiting to the operating system or continuing execution 
of instructions within the program. When a selected interrupt is generated, con- 
trol will be returned to the program. 



LDQ 


=N$00A1 


PTR FUNC/STATUS 


ENA 


1 


CLR CONTROLLER 


OUT 


-1 


FUNC TO PTR 


ENA 


$34 


START MOTOR, ALARM, DATA 


OUT 


-1 


FUNC TO A 


Exit 







When the interrupt returns control to the program, status must be taken to deter- 
mine which of the two interrupts was generated, data or alarm. If the data 
interrupt was generated, the programmer brings the data into A and saves it. 
Once the data is saved, a check should be made to determine if all data has been 
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transferred. If the operation was not complete, the programmer should re- 
select interrupts and exit, waiting for the next interrupt. 

7. 2 BUFFERED I/O EXAMPLE 

The A/Q channel prohibits the execution of other instructions while data is being trans- 
ferred. The reason is obvious: the Q register and A register, which are used for I/O, 
are also the arithmetic registers. A direct storage access (DSA) channel may be con- 
nected to the 1704. The DSA transfers data directly to memory, bypassing the A and 
Q registers. Therefore, a program may be executing while data is being transferred. 
The direct storage of data is referred to as BUFFERING. The A/Q channel is used to 
send functions and receive status, but the data is transferred via the DSA. The disk is 
an example of a buffered device. 




O 
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SIDE VIEW: 
850 DISK PACK 
(6 DISKS) 



^. 






DISK SURFACE 
DISK SURFACE 1 



I 



DISK SURFACE 9 



TOP VIEW: 
DISK SURFACE 



CYLINDER 00 J 



CYLINDER 99-T 




SECTOR 14 
SECTOR 15 
SECTOR 
SECTOR 1 



DIRECTION OF 
ROTATION 

853 contains 100 cylinders; 854 contains 200 cylinders. 
Figure 14. Side and Top Views of 850 Disk Pack 

7. 2. 1 Disk Functions 

The program selects the disk by setting the Q register with the equipment 
number and the desired director bits. Throughout this discussion the disk shall 
be considered equipment number 8. 
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15 14 13 12 11 10 
Q |~0 I 1 







~v~ 



D 



EQUIP 8 

The setting of the director bits will define the operation and the information to be 
sent from or received in the A register. 



(A) depends upon D field of Q 



Q 



D 



DISK FUNCTION CODES 



Value Set in Q 






(Bits 02-00) 


Output from A 


Input to A 


001 


Director function 


Director status 


010 


Load address 


Address register status 


011 


Write 




100 


Read 




101 


Compare 




110 


Checkword check 




111 


Write address 
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7. 2. 1. 1 Director Function 






D = 001 , OUT 






LDQ 


=N$0401 


DISK FOR FUNC 


LDA* 


FUNC 


FUNC IN A 


NOP 






OUT 


-1 


FUNC TO CONT] 



•'"> 



A 



15 10 


9 


8 


r 


1 


6 


5 


i 


4 


t 


3 




2 


] 


L 





^^^^^^^ 








^^ 










& 


UNIT SELECT CODE* f a t t ' 


i n 


UNIT SELECT 












RELEASE 










ALARM INTERRUPT 








END OF OPERATION INTERRUPT 








READY & NOT BUSY INTERRUPT 


i 









CLEAR INTERRUPT 

The clear interrupt function will clear all selected interrupts, allowing the 
programmer to select the interrupts he desires. Three interrupts may be 
selected: next ready and not busy status, end of operation, and alarm. The next 
ready and not busy interrupt occurs when the 1738 becomes not busy but still 
holds its ready status. 

The end of operation interrupt allows the controller to inform the 1700 when 
it has completed an operation such as a data transfer. The alarm interrupt 
will notify the 1700 that an alarm condition has arisen. There are eight possible 
alarm conditions: not ready, checkword error, lost data, seek error, address 
error, defective track, storage parity error, and protect fault. 

The release function allows an unprotected program to use the disk even though 
the protect switch on the disk is still set. A protected program must issue the 
release function. The next time a protected program accesses the disk, the disk 
will become protected and must again be released before it will become accessible 
to an unprotected program. 

The unit select and unit select code will always be zero unle s s two disks are 
connected to the controller. Bit 8 is the unit select bit. It informs the con- 
troller that the program will select unit or unit 1. Bit 9 indicates which unit 
bit 8 wishes to select. If 9 bit is a 0, unit is selected; if it is a 1, unit lis 
selected. The controller ignores bit 9 unless bit 8 is set. 
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7. 2. 1. 2 Load Address Function 



D = 010 , OUT 



Once the functions have been sent to the controller, the program notifies the con- 
troller of the beginning addr es s on the disk to be used by the program. The Q 
register is loaded with the D portion set to 010 and the disk address (sector 
record address) is placed in the A register (Figure 14). 

DISK FOR DISK ADDR 
ADDR IN A 

ADDR TO THE DISK 

The controller will position the Read/Write heads on the requested address. The 
heads will be moved directly to the address forward or backward, depending on the 
current location of the Read/Write heads. The address held in the A register 
will be in the following format. 



LDQ 


=N$0402 


LDA 


=XDISKAD 


NOP 




OUT 


-1 



15 




8 


7 




4 


3 







CYLINDER 


HEAD 


SECTOR 



r I The disk has been functioned and given the desired disk address. The next step 

will be to initiate one of three operations. 

WRITE D = Oil 

READ D = 100 

COMPARE D = 101 

7. 2. 1. 3 Write Function 

D = 011 , OUT 

The write function code requests the controller to prepare to read data from 
memory and write it on the disk. 

DISK TO WRITE 

MEMORY ADDR IN A 

WRITE OPERATION INITIATED 

The controller expects to find the first word address minus 1 (FWA-1) of the buf- 
fer area in the A register when the write function is received. The controller 
goes into memory via the DSA to the FWA-1, at which location the controller ex- 
tracts the last word address plus 1 (LWA+1). The controller keeps the LWA+1 
and updates the FWA-1 until the two are equal; at this point the write operation 

f~^ is complete. The controller updates the address each time a 16-bit data word is 

"-- - y transferred from memory. 
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LDQ 


=N$0403 


LDA 


=XMEMADR 


OUT 


-1 



7.2.1.3 



DATA BUFFER FOR DISK 



FWA- 



LWA- 




)> DATA 



FWA - 1 MUST CONTAIN LWA + 1 OF BUFFER 

Prior to issuing the write operation, the interrupts must be selected, the sector 
record address must be sent to the controller and the LWA+1 of the buffer area 
must be at the FWA-1. 



LDQ 


=N$0401 


LDA* 


FUNC 


NOP 




OUT 


-1 


LDQ 


=N$0402 


LDA 


=XDISKAD 


NOP 




OUT 


-1 


LDA 


=XLWAP1 


STA 


FWAMI 


LDQ 


=N$0403 


LDA 


=XFWAM1 


NOP 




OUT 


-1 



DISK FOR FUNC 
SELECTED INT IN A 

INT SELECTED 
DISK FOR DISK ADDR 
ADDR IN A 

HEADS POSITIONED 
LWA+1 IN A 
LWA+1 AT FWA-1 
DISK TO WRITE 
FWA-1 IN A 

OPERATION INITIATED 



The 1704 continues executing instructions while the disk transfers data. When 
the data has all been transferred or an alarm condition has arisen, the 1704 will 
be notified. 



r 
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7. 2. 1. 4 Read Function 

D = 100 ; OUT 

The read function code follows the same programming procedure as the write 
function, the differences being the D setting of Q and the fact that the disk reads 
data into memory rather than writing data on the disk. 

7. 2. 1. 5 Compare Function 



D = 101 ; OUT 

The compare function code follows the same programming procedure as the 
read and write function codes. The compare function causes the controller 
to read data from the computer's memory and compare it with the data stored on 
the disk. If at any time during the compare, one word does not compare, the no 
compare status bit will be set. This function provides an extra check on the 
validity of the data transferred. 

The checkword check (D=110) and write address (D=lll) functions are used by the 
customer engineers. 



7. 2. 2 Disk Status 



\^ 



O 



7. 2. 2. 1 Director Status 

D = 001 , INP 

Status may be taken to monitor the operation of the disk. Once the disk gen- 
erates an interrupt, status must be taken to determine which interrupt was gen- 
erated. This is accomplished by loading the Q register with the D portion set 
to 001 and by issuing an INP instruction. 



LDQ 
NOP 
INP 



15 14 13 12 11 10 



=N$0401 

-1 

9 8 



A 



PRODUCT FAULT 
STORAGE PARITY ERROR 

DEFECTIVE TRACK 

ADDRESS ERROR 

SEEK ERROR 

LOST DATA 
CHECKWORD ERROR 

PROTECTED 

NO COMPARE 



DISK FOR STATUS 

STATUS IN A 
6 5 4 3 



READY 
BUSY 
INTERRUPT 
ON CYLINDER 
END OF OPERATION 
ALARM 
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The ready status indicates that the unit is available. The busy bit indicates 
that the controller and/or the drive unit is presently involved in the performance 
of an operation. This bit is set with the acceptance of a load address, write, 
read, compare, checkword check, or write address function. At the completion 
of the function which set the busy status, the status will be cleared and the disk 
will become not busy. Once the disk is not busy, a new function may be issued. 

The interrupt bit acknowledges that an interrupt has occurred. Further ex- 
amination of A will determine which of the three selected interrupts was gen- 
erated: bit 4 (EOP) and bit 5 (ALARM). 

If neither bit 4 nor bit 5 is set, the programmer should check bits and 1 for 
ready and not busy. If the alarm bit is set, the programmer must determine 
which of the eight alarm conditions caused the interrupt. 

The on cylinder status bit 3 is set when the Read/Write heads have reached the 
sector record address initially sent to the controller via the A/Q channel. 

7. 2. 2. 2 Address Register Status 

D = 010 ; INP 

The programmer may request the disk to return the current position of the Read/ 
Write heads at any time by selecting the disk as above but issuing an INP instruc- 
tion. 



LDQ 


=N$0402 


DISK FOR DISK ADDR 


NOP 






INP 


-1 


CURRENT ADDR IN A 



The address will be in the same format used to send the address to the controller. 

7.2.3 Summary, Buffered I/O 

The DSA provides the 1704 with a means of storing data directly in memory; this 
permits the execution of instructions while transferring data. The program sends 
the function word, the sector record address, and stores the LWA+1 of the buffer 
area at the FWA-1 prior to initiating an operation. The operation is indicated by 
the D portion of Q, with the A register containing the FWA-1 of the buffer area. 
The controller interrupts the 1704 when a selected interrupt condition arises. 
The program takes status to determine which of the selected interrupts was gen- 
erated. 
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8.1 OPERATING SYSTEMS 



The 1700 computer system has two commonly used operating systems: the utility system 
and the mass storage operating system (MSOS). MSOS is a disk or drum oriented sys- 
tem and allocates the resources of the computer according to a priority system. The 
utility system is a much smaller system. It provides for assembly, loading, and execu- 
tion of programs in a batch mode. 

8.1.1 Utility 

The 1700 utility system provides the 1700 computer with a means of loading and 
executing programs in configurations smaller than the minimum required for the 
1700 operating system. The utility system requires 8K of core but no disk or 
drum. I/O is by way of the paper tape reader and paper tape punch, and listing 
and operator control is through the teletype. * Execution of jobs through the 
utility system can make use of the standard drivers provided by utility. The 
standard drivers provided are for the teletype, paper tape input, and paper tape 
output. It is possible, then, to operate these devices in one's own program by 
simply using a standard calling sequence. 

8.1.2 MSOS 

Under MSOS core is divided into two areas: foreground and background. The 
foreground is for system and process programs. System programs are those 
programs that make up the operating system, such as the job processor and 
drivers. Process programs are those application programs that are most im- 
portant to the particular installation. For example, if the system is controlling a 
chemical plant operation, those programs monitoring the chemical process are 
the process programs. The process programs and system programs usually 
have the highest priority and have access to the resources of the computer first. 
Foreground is protected; this means the on-line process programs cannot be de- 
stroyed by programs in the background and they cannot be inadvertently brought 
into execution by background programs. However, background programs may 
make use of protected routines such as I/O drivers. 

Background programs are run in a batch mode (serially) and run at the lowest 
priorities in the system. Programs in the background are called jobs. Assem- 
bling, compiling, and loading are examples of such jobs. 

8. 2 REQUEST PROCESSING 

Three basic functions of the operating system are to: (1) allocate core space to those 
programs that want to use it, (2) communicate with the outside world, i.e., supervise 
I/O operations, and (3) allocate CPU time between the various programs. When a pro- 
gram wants one of these functions done, a request is made to the operating system. 



o 



*There are other options available. 
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A request takes the form of a transfer of control to the module of the operating system 
that processes requests (the request entry processor, entry point name MONI) followed 
by words containing the necessary parameters for the particular request. 

The entry addr es s for MONI is always located in core location F4 so every request is 
initiated by an indirect return jump through F4. The return jump will provide the link- 
age necessary. The parameter string length is different for different requests: 



54F4 RTJ ($F4) TO MONI 

xxxx 1 Request code 

xxxx ( and other parameters 



hi the first parameter word, bit positions 9 through 14 will be the request code. This is 
for all requests. 

MONI saves the registers of the requesting program in a special core area called volatile 
storage and gives control to a request processor denoted by the request code in the para- 
meter list. This processor must return control to the request exit processor which re- 
turns control to the requesting program. 

The 1700 operating system provides the user with up to 30 monitor requests; 20 are 
reserved for the operating system. However, they may be replaced by user-written pro- 
cessors when the system is initiated. The other 10 requests maybe added at initialization 
by including in the resident load the necessary programs with the required entry points. 
The number of possible request processors can be extended from 30 to 63 by reassembly. 

Each request processor is a separate submodule and has a coded entry point with one of 
the following names: 



reserved for system use 



available to users 



The numerical part of each name is the request code. It corresponds to the value of an 
index to a table of request processor addresses contained in MONI. 

MONI has these entry points as externals providing linkage with each appropriate request 
processor. 

Since the numeric part of the entry point name for each request processor must corres- 
pond to its request code, a request code of 5 will provide entry through MONI to module 
T5. 
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Request 
Entry- 
Processor 










^ 



Tl 



Request Submodules 



T2 



T30 



O 
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Users can assemble an added request processor, assign a request code to it, and affix 
the entry point with T followed by the number for the request code and incorporate it as 
part of the system. 

8. 2. 1 Summary of Request Processing 



Note that all requests begin with the return jump toMONIand that MONI determines which 
type of request it is by examining the request code in the first word of the parameter 
string. Each type of request has a request processor to which MONI gives control, 
depending on the request code. When control is given to the request processor, several 
functions take place before control is returned to the requesting program. 

It is important for the programmer to understand that a request only initiates action de- 
sired of the operating system. It does not do anything. In most cases, a request causes 
the desired action only to be put on a queue; control is returned immediately to the 
requestor at the next instruction beneath the parameter string. 

For example, it is desired to write a message on logical unit 4: 



REQ 



RTJ- ($F4) 
(Parameters for a 
write request on 
logical unit 4) 



RET 



Control is passed to MONI. MONI passes control to the Read/Write request processor 
which puts the request on a queue of other messages waiting to be printed on logical unit 
4. Control then passes to the request exit routine which returns control to the requestor 
at RET. The message has not yet been written but it will be done in due time. 
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RT J- ($F4) 



TO MONI 




Back 

to 

program 



/To 
appropriate 
request 
processor; 

Request 
gets on a 
queue 



TO REQXT 



Request 

processor 

exits 



Figure 15. Flow of Requests 

8.3 REQUESTS 

The following requests are included in the standard operating system: 
READ* 



WRITE* 

FREAD* 

FWRITE* 

SCHEDULE 

TIMER 

EXIT* 

CORE 

LOADER 

GTFILE 

STATUS* 

SPACE 
RELEASE 



> 



> 



Available to both foreground and 
background programs. 



Available only to background programs. 

Request processor modules for these 
requests must have the same residency 
as the job processor. 



Available only to foreground programs. 



INDIR is an indirect version of any of the listed requests. 
The job processor can make any request. 



C 



*These requests are included in the utility system. 
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8.3 

System macro calls are available to generate the code for the requests under the macro 
assembler, which runs under MSOS. Codes for the requests under the utility system 
must be coded by the programmer. 

hi this chapter those requests that are available to background programs will be dis- 
cussed. Those requests available only to foreground programs will be discussed in 
Chapter 11. 

Any of the allowable requests for background programs will be accepted by the operating 
system and put on the desired queue. They will not be rejected. 



O 
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RC 



NUM 



EXIT 

FWRITE 9. , c, s, n, m, rp, cp, a, x* 

FREAD £,c,s,n,m, rp, cp, a,x* 

WRITE £ , c, s, n, m, rp, cp, a, x* 

READ £,c,s,n, m, rp, cp, a,x* 

SCHDLE c,p,x 

TIMER c,p,x,Q,u -* Parameter in Q 

CORE -* Parameters in A and Q 

LOADER •* Parameters in A and Q 

GTFILE c,f, s,wl,w2,x, rp, cp 

STATUS C,ap,a,x 

INDIR (ap) 



General Definitions 

£ logical unit 

c completion address 

s starting address of data block 

n number of words 

m mode 

rp request priority 

cp completion priority 

ap address of parameter list 

p priority 

u units 

f index 

x mode of addressing indicator for c, s,n,f, and ap in STATUS 

a mode of addressing indicator for logical unit 

Figure 16. Macro Calls for Requests Available to Background Programs 



5 


0A00 


6 


OCXX- 


4 


08XX 


2 


04XX 


1 


02XX 


9 


12XX 


8 


10XX 


11 


1600 


7 


0E00 


13 


1A01 


3 


0600 



*For mass storage devices the programmer sets up two words following the request to contain 
the mass storage address. 
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8.3.1 

3, 1 EXIT Request - Request Code 5 

The EXIT request is available only to background programs. 

When control is to be given back to the job processor, the EXIT request is used. 
This may be when the program has reached a point where it has completely 
finished its goal and wants to terminate itself or when it wants to give up control 
while waiting for an I/O operation to take place. 

The EXIT assembles into two words in the following manner: 






000101 


000000000 



RC= 5 





54F4 






0A00 




macro call: 


EXIT 




coded call: 








RTJ- 


($F4) 




NUM 


$0A00 



Most of the examples in this chapter have at least one EXIT request; check them 
for its use and assembly. 

If this request were executed in a completion routine, normal processing of a job 
would resume at the location where it was interrupted. If this request was not 
executed in a completion routine, the job is considered complete. 

The EXIT request simply causes a jump to the dispatcher which could be accom- 
plished by: 

EQU ADISP($EA) 

JMP- (ADISP) 
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This would be abetter way to code exits since it saves time and since protected 
programs cannot make EXIT requests. 

In the background, the jump to the dispatcher can be used only under MSOS 2. 0; 
under 1. it can only be used in the foreground. 

8. 3. 2 Read/Write Requests - Request Code 1, 2, 4, 6 

For peripheral equipment that more than one program may use, a standard driver 
for each is written and incorporated into the operating system. The programmer 
makes use of the driver when he makes a Read/Write request to the operating 
system. Read/ Write requests are available to both foreground and background 
programs. 

When the programmer wants to communicate with a peripheral device, he makes 
a READ, WRITE, FREAD, or FWRITE request. Reads are used when informa- 
tion is to be brought into core and writes when information is to be transferred 
from core to the device. 

When a Read/Write request is made, the transfer of data is only initiated. If the 
driver is busy working on another request, the new request is placed in a list of 
requests waiting to use the device. The position of the request on the queue will 
depend on the request priority. The request itself is not placed on a stack but is 
simply threaded. When the device is free and the transfer begins, there will be a 
period of time lapse before the complete transfer has taken place. During this 
time, control is given back to the requesting program so that it may execute any 
portion of the program that is not dependent upon the data. Therefore, when con- 
trol returns to the instruction immediately following the parameter list, the pro- 
grammer cannot assume that the transfer of data has been completed or, for that 
matter, even begun. 

The programmer specifies a completion address in the request. Control will be 
given to this address when the request has been completed, according to the com- 
pletion priority in the request. 

This completion address is where the device driver will schedule reentry after the 
particular request has been completed. This scheduling of the completion address 
is done by the driver using the SCHDLE schedule request; this completion address 
is scheduled by priority. There are, then, parameters in the Read/Write requests 
to signify the priority of the request itself and the priority of the completion 
address. 
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8. 3. 2. 1 Format of the Read/Write Request 



REQ 












RTJ- 




($F4) 


i 




1 


15 


14 


RC 9 
1, 2, 4, 6 


8 

X 

0,1 


7 


4 
RP 

0-15 


3 CP ° 
0-15 




15 


14 


c 
COMPLETION ADDRESS 







« 2 

(0 

a 

u 

« 

1 
2 4 


THREAD WORD = 


15 
ERROR 


14 
SHORT 


13 
DEVICE 


12 
M 
0,1 


11 10 

A | 
1 


9 


LOGICAL UNIT 





v 


READ 


FAILED* 


15 
0,1 


14 


n 
NUMBER OF WORDS 









5 
6 
7 


15 
0,1 


14 


s 
FIRST WORD ADDRESS OF BUFFER 









15 




msb 
MOST SIGNIFICANT BITS OF MS ADDR. 







' 


15 



14 


Isb 
LEAST SIGNIFICANT BITS OF MS ADDR. 








o 



re 

x 

rp 

cp 

c 

thread 

v 

m 

a 



request code, 6 bits: WRITE = 2, READ = 1, FWRITE = 6, FREAD = 4 
relative/ indirect indicator: or 1 

request priority, 4 bits, 0-15: position of request on driver's thread 
completion priority: 0-15 
completion address, bit 15 set if (c) 

word, is used by the system: equals zero when request is not active, non- 
zero when active 

error code passed to the completion address inQ and set in the parameter 
list when the request is completed 
mode bit: = binary, 1 = ASCII 
logical unit, 10 bits; modified by a 
settings for the a parameter (logical unit address indicator), 2 bits: 

a = blank =GD 



a= R = 
a= 1 = 



01 
10 



£ is a logical unit number 



£ is a signed increment (+1FF) 
£ is a core address (0<£<3FF) 

s starting word of storage block, bit 15 set if (s) 
msb-lsb set up by the programmer if logical unit specifies a mass storage device 

The type of addressing used is determined by the request code. Background pro- 
grams can access scratch only; sector 0, word refers to the first word of 
scratch. These two words should be included in the request only if a mass storage 
device is involved. The macro call does not assemble them so the code must be 
added for them. 
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8.3.2.1 

The macro call is: 



L 



FREAD 
REQ READ £, c,s,n, m,rp, cp, a,x 

FWRITE 
WRITE 

REQ will be on the 54F4, which will be generated. REQ+1 is the first word of the 
parameter string. The parameter list is the same for all four of the Read/ Write 
requests. 

An example of a coded call would be: 



RTJ- 


($F4) 


NUM 


$0C01 


ADC 


COMPL 


NUM 





NUM 


$1004 


NUM 


35 


ADC 


BUF 



8. 3. 2. 2 Request Code 

There are four input/output requests handled by the Read/Write request processor 
RW, which has entry points Tl, T2, T4, T6 for them. 



READ 
FREAD 
WRITE 
FWRITE 

The manner in which the data is to appear on the device is determined by which 
form of the request is used. FWRITE and FREAD are used for formatted trans- 
fers and READ and WRITE are used for unformatted transfers. 

8. 3. 2. 2. 1 Format of Records 



Request Code 


NUM 


1 

4 
2 
6 


$02XX 
$08XX 
$04XX 
$0CXX 



The format in which data may appear on a device is different for each device and 
driver. This information is given in the manual for each driver. The record 
formats for devices included in the minimum equipment configuration are outlined 
on the following page. 
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8. 3* 2. 2. 1, 1 

8.3.2.2.1.1 Teletype 

FREAD 

A format record for a teletype read operation consists of any number of characters 
followed by a carriage return. Format reading continues until a carriage return 
is detected or the requested number of words is transferred. If the requested 
number of words is transferred before the carriage return is detected, reading 
continues but no more data is transferred. A delete character will terminate data 
transfer until the next carriage return. The request will then be repeated. Line 
feed characters are not transferred in a format read. Before a f o r m a t read on 
the teletypewriter begins, the break light is turned on; therefore, type in must be 
preceded by pressing the break release. 

FWRITE 

A format record for a teletype write operation consists of any number of charac- 
ters following a carriage return and line feed character. A format write is the 
same as an ordinary write except that the driver supplies a carriage return and 
line feed character before beginning the transfer of data for a format write 
request. 

READ 

In an unformatted read, the number of words requested is filled starting at the 
specified address. Two characters fill one word; the first character is put into 
the upper half of the word. All carriage control must be provided by the program- 
mer. 

WRITE 

hi an unformatted write, two characters are transferred per word. The infor- 
mation must be stored in ASCII since no conversion is made from binary. 

8. 3. 2. 2. 1. 2 Paper Tape Reader and Paper Tape Punch 

A format record for the paper tape reader and punch depends on mode, hi ASCII 
mode, it is any number of characters preceding a carriage return, hi binary 
mode, it is any number of words preceded by a word which represents the ones 
complement of the number of words to be transferred and followed by a word con- 
taining a checksum. If the number of words to be transferred is greater than 
21, 759, the first word represents the ones complement of the number of words to 
be transferred plus 256. 

If the first character of the header word in a format record (requested in binary 
mode) is an asterisk, the r ec ord is read in ASCII mode. This allows ASCII and 
binary mode records to be mixed. 
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8. 3. 2. 2. 1* 2 



FREAD, ASCII 

For a format read, ASCII mode, characters are read until a carriage return is 
detected or the requested number of words has been transferred. If the requested 
number of words is transferred before a carriage return is detected, reading will 
continue but no additional data will be transferred. Nulls (blank tape) preceding 
a format record are skipped; no data transfer takes place until a non-blank char- 
acter is detected. Line feed characters detected during the read are not trans- 
ferred; delete characters are ignored. All characters are checked for even 
parity. 

FREAD, Binary 

Format reading in binary mode continues until the word count is exhausted or the 
requested number of words has been transferred. If the latter occurs before the 
count is exhausted, reading will continue but no additional data will be transferred. 
The checksum is verified after the entire record is read. If the first character 
of the header word is an asterisk, the record is read in ASCII mode in spite of the 
binary mode declaration. Nulls (blank tape) preceding a format record are skipped. 

FWRITE, WRITE 

A format write is the same as an ordinary write request except the driver supplies 
carriage return and line feed characters after the end of the operation. 

In ASCII mode format write, characters are transferred from the specified core 
block' until the word count is exhausted. A parity bit is added to each character, 
hi binary mode, format write, characters are transferred until the word count is 
exhausted. Word count is the first word on the tape and is the ones complement 
of block size. The driver supplies a checksum word after the data. 

Checksum 

The driver generates the checksum word on a paper tape by accumulating a sum 
of the word count word (which is the complement of the data block size and is out- 
put on the tape first) plus all the data words, disregarding any overflow. This 
sum is then complemented and output as the last word in the block on the tape. 
For example, if the data words are $F001, $E001, $E002, $E003, and $B005, the 
word count will be 5 and the sum of the data 4010. The checksum will be $BFF4 
which is $FFFA (complement of 0005) plus $4010, which is $400B; the comple- 
ment of $400B is $BFF4. The tape will contain FFFA, F001, E001, E002, E003, 
B005, BFF4. 

When the checksum word is read on input, it will result in zero when the word 
count word is read, the data words added to it, and then the checksum word is 
added to that. For example, on the above tape the word count word FFFA is read 
first, the data totalling 4010 is added to it as the data is read, giving 400B. When 
the checksum BFF4 is read and added, the sum will be FFFF arithmetically, 
which will be 0000 by the subtractive adder. 

The paper tape on page 8-14 contains the data used in these examples. 
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8.3.2.2.1.2 

The following example program shows the paper tape output for all four kinds of 
writes. It writes 100 words of data from a buffer BUF. The data in the buffer is 
1-64 (1-100 ). The buffer is written out from the end to the beginning. 



O 



0001 








NAM 


0002 








ENT 


0003 


P0000 


0000 


WRITE 





0004 






a 




0005 






# 




0006 


P0001 


0C63 




ENQ 


0007 


P000? 


0A00 




EMA 


0008 


P00.03 


0901 


DATA 


IMA 


0009 


P0004 


6A21 




STA* 


0010 


P0005 


014? 




SOZ 


0011 


P0006 


ODFE 




IMQ 


0012 


P0007 


18FB 




JMP* 


0013 






■» 




0014 






# 




0015 


P000S 


54F4 


PUNCH 


RTJ- 


0016 


P0009 


0401 




NUM 


0017 


P000A 


0000 




NUM 


0018 


P000B 


0000 




NUM 


0019 


P000C 


0003 




NUM 


0020 


P000D 


0064 




' NUM 


0021 


poooe 


0025 ° 




ADC 


0022 






■a- 




0023 


pooof 


54F4 




RTJ- 


0024 


P0010 


0401 




NUM 


0025 


P0011 


0000 




NUM 


0026 


P0012 


0000 




NUM 


0027 


P0013 


1003 




NUM 


0028 


P0014 


0064 




NUM 


0029 


P0015 


025 P 




ADC 


0030 






■a- 




0031 


PQ016 


54F4 




RTJ- 


0032 


P0017 


0C01 




NUM 


0033 


P0018 


0000 




NUM 


0034 


P00 19 


0000 




NUM 


0035 


P001A 


1003 




NUM 


0036 


POO IB 


0064 




NUM 


0037 


P001C 


0025 P 




ADC 


0038 






# 




0039 


P001O 


54F4 




RTJ- 


0040 


P001E 


0C01 




NUM 


0041 


P001F 


0000 




NUM 


0042 


'P0020 


0000 




NUM 


0043 


P0021 


0003 




NUM 


0044 


P0022 


0064 




NUM 


0045 


P0023 


0025 P 




ADC 


0046 






■B- 




0047 


P0024 


14EA 




JMP- 


0048 


P0025 


0064 


BUF 


8ZS 


0049 








END 



TEST WRITE INSTRUCTIONS 

WRITE 





THIS IS HOW TO GENERATE DATA 
IN A PROGRAM FOR A TEST 



99 



1 

BUF*Q 

PUNCH-*- 1 

-1 

DATA 



($F4) 

S0401 





$0003 

100 

BUF 

($F4) 

$0401 





$1003 

100 

BUF 

($F4) 

S0C01 





$1003 

100 

BUF 

($F4) 

S0C01 





$0003 

BUF 

(SEA) 

BUF(IOO) 

WRITE 



WRITE* BINARY 



WRITE, ASCII 



FWRI-TE* ASCII 



FWRITE* BINARY 
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8. 3, 2i, 2i, 1, 2 



OOFF WRTTF O00()t> O^TA nnOT^ P'JNC* 0008P m.lF 0025P 
(NOTE THAT DATA IS NOT BLOCKED) 



WRITE 
BINARY 



WRITE 
ASCII 



FWRITE 
ASCII 



FWRITE 
BINARY 



Parity 
Bit 



WORD 
COUNT 




• •• •• 

• • • •• 

• •• * • 

• • # • 






• < 


» • 








•••••• 








• •••• 








• ••• • 








• • • • 








• • • •• 








• • • • 








• • • • 
















• • ••• 






• • »• •• 

• 

• • • • • 


• • 

1 


• • • 
'■ • ■ » * 









JKSUM 
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1.3.2.2.1.3 



8. 3. 2. 2. 1. 3 Mass Storage Addressing 



When the logical unit in a read/write request specifies a mass storage device, 
the address to be accessed must be in the two words following the parameter list. 
This must be set up by the programmer. For example: 



READ 

NUM 



»>»>>»»» 



$0000, 0002 



(sector 2) 



Since all transfers to and from mass storage do not have a mode or format as- 
sociated with them; that is, what is written on the disk is a mirror image of the 
contents of core, the. formatted and unformatted forms of the request determine 
the type of addressing that will be used. Formatted requests mean sector addres- 
sing and Read/Write assumes word addressing. Check the manual for the 
driver for the exact details of addressing mass storage. Sector addressing can 
always be used; word addressing can only be used under systems which have the 
disk word driver. 

In the background a program can access only the scratch area of the disk or drum 
through read/write requests. Therefore, sector one or word one in the back- 
ground is sector or word one of the scratch area. 



O 



8.3.2.3 XBit 



The x bit is used in conjunction with the cp, n, and s parameters to indicate 
direct, indirect, or relative location of those parameters. It will be discussed 
as it relates to each parameter. 

As a rule, the xbit= is satisfactory for background programs, with all the 
associated parameters direct. 













c 









n 





s 



Its use as relative (for run anywhere programs) will be discussed in detail in 
Chapter 11. When the x bit = 1, the c and s parameters must be relative! 
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8.3.2.4 

8.3.2.4 Request Priority 

The request priority indicates to the operating system the priority of this request 
in relation to the other programs requesting use of the device. The request 
priority has nothing to do with the running priority of the program. In the back- 
ground the rp parameter is always 0. 

Since the request priority determines the position of the request on the queue for 
the driver, the reads and writes done by jobs at priority will always be on the 
bottom of the queue and therefore will be done last. 

This is why, for example, if a job and a process program are both writing mes- 
sages on a remote teletype, the messages will be interspersed together with the 
process program's messages taking priority over the job's. 

8. 3. 2. 5 Completion Priority 

The completion priority is the priority at which the completion routine is to run. 
For background jobs, cp is always 1. Since the running priority for jobs is al- 
ways 0, the completion priority of 1 will cause the job to be interrupted, when the 
driver has finished the I/O, and the completion routine to be entered. (When the 
completion routine exits, control is returned by the dispatcher to the location 
where the job was interrupted. ) 

A completion priority greater than the running priority will always cause a pseudo 
interrupt of the program and will cause the priority to be changed higher and the 
completion address entered. A cp equal to or less than the running priority will 
cause the completion routine not to be entered until after the program exits and 
the priority structure works down to the desired level. 

8. 3. 2. 6 Completion Address 

The completion address is scheduled by the driver as a program when the transfer 
is completed, or terminated by an error. The completion address is scheduled at 
a particular priority specified by the cp parameter. In the background cp is 
always 1. 

This completion routine is generally short because, under the utility system, 
when it is entered the interrupt mask is set to prevent external interrupts from 
occurring. Under MSOS, interrupts are not locked out while the completion rou- 
tine is being executed, so process equipment can interrupt. 

The completion address may be omitted; then no address is scheduled upon com- 
pletion. 

When control is given to the completion address, the Q register will contain a 3- 
bit code in the upper three bits of Q. These bits can also be found in the v field 
of the fourth word of the reauest. 
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8.3.2.6 



Bit 



Value 



15 







1 


14 







1 


13 







1 



Condition 

Error free operation 

Error occurred (device failure) 

Requested number of words transferred 

Less than requested number of words trans- 
ferred during a read or format read (short 
read) 

Error occurred because device was not ready 

Error was due to failure of the device; de- 
vice is ready 



O 



The Q register should always be checked for the possibility that an error occurred. 
For example, if a short read occurred on a READ request, bit 14 would equal 1. 
Bit 15 would indicate whether it was a legal short read (Q15=0), or due to device 
failure (Q15=l). If it was due to device failure, bit 13 would indicate whether the 
device is ready or not. 

The programmer could find out how much of the data was transferred by the last 
word of the data buffer. This word would contain the address plus 1 of the last 
word transferred. Thus, by subtracting the contents of the last word in the buffer 
from the first word address of the buffer, the number of words can be found. If, 
for example, a read of 50 words was requested but only 25 words were read: 



BUF 
BUF+24 


t 

25 words 
read 

i 


LDA =XBUF 
SUB BUF+49 










BUF+49 


BUF+25 








(A) = BUF 
- BUF+25 



(A) = 25 



Each appropriate driver manual will indicate possible error conditions. 

The completion address may be specified in several ways. The x parameter 
determines the mode of addressing that is used for the completion address. 
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x c 

or blank c 



^0 
^blank 



(c) 



The meaning of c 

c is the completion address 

e. g. , FWRITE -, COMPL, -, -, -, -, -, -, 
COMPL is assembled as an absolute address 
(program relocatable). 



c is relative 

c is a positive increment added to the address 
of the first word of the parameter list to locate 
the completion address. 

i. e. , FWRITE -, COMPL- *+l, -, -, -, -, -, -,X 
hi the example the completion address is at 
COMPL. 

c in parentheses represents an index to the sys- 
tem library, x has no meaning. 



Note that there is no indirect version for the completion address. 

The option (c) cannot be used in the background because the programs on the 
system library may not be scheduled from the background; see Chapter 11. 

A completion routine in one's own program may bescheduledin one of the fol- 
lowing ways: 



0001 

0002 

0003 GO 

0003 P0000 54F4 

0003 P0001 0C01 

0003 P0002 0009 P -« 

P0003 0000 

0003 P0004 0004 

0003 P0005 0009 
P0006 001AP 

0004 

0004 P0007 54F4 

0004 P0008 OAO0 

0005 P COMPL1 



0006 $ 
0006 P000B 54F4 
0006 P000C 0D01 
0006 P000D 0008 
P000E 0000 
0006 P000F 0004 

0006 P0010 0009 
POOH 000E 

0007 

0007 P0012 54F4 

0007 P0013 OAOO 

0008 P0014 0172 



C0MP2 



NAM D - R/W EXAMPLE 

ENT GO 

FWRITE 4, C0MPL1, EXAMPLE, 9, B, 0, 1, A, 

\ \ 

completion address 



EXIT 



FWRITE 4, C0MP2-*+l, EXAMPLE-*+5, 9, B, 0, 1, A, X 

\ \ 

Relative distance to completion address 



EXIT 



SQM ERROR 
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8, 3. 2. 6 

Note that the first assembles with a P following the completion address, meaning 
that it is direct and will be absolutized at load time (the actual core address filled 
in); so the program will be relocatable. 

The second example is relative to the first word of the parameter list. Also, in 
the second example, note that the 8 refers to the location where the parameter 
is but that the parameter address must be relative to the first word of the para- 
meter list, hence COMP2-*+l. The x bit must be set in the first word. 

8.3.2.7 Thread Word 

The thread word must always be initialized toO or the request cannot be executed. 
The thread word is used by the operating system for the queue for requests and 
also for the completion. It is non-zero during the entire time the request is being 
processed and while the I/O is being done. It does not become zero again until 
the operation is complete. 

8.3.2.8 Error Code 

The 3-bit v field in the fourth word of the parameter string is the same 3-bit 
error code that comes back to the Q register at completion. It will be set by the 
driver whether or not there is a completion routine. Therefore, a program not 
using a completion routine may check the v field for errors. 

8.3.2.9 Mode 

The m parameter tells the driver whether the data is stored in core in Binary 
or ASCII. When m is A (or, if coded, 1) it means the data is stored in ASCII, 
and B (or, if coded, 0) means Binary. 

8. 3. 2. 10 A Field 

The a bits modify the logical unit field, indicating whether the logical unit field 
contains the actual logical unit number, an indirect address containing the LUN, 
or a relative distance to LUN. The a bits will be discussed under the logical unit 
heading. 

8. 3. 2. 11 Logical Unit 

The logical unit may be specified directly (i. e. , £ =4), a word may be specified 
that contains the logical unit, or a relative distance to the address of the LUN may 
be specified. The a parameter indicates which form of the £ parameter the pro- 
grammer has used. 
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5.3.2.11 




Meaning of the C parameter ( 

the parameter is the logical unit 

e. g. , FWRITE 13, -, -, -, -, -, -, 0, - 

£ is indirect 

£ is an absolute location that contains the logical unit 

e. g. , FREAD $FD, -, -, -, -, -, -, I, - 
is used when standard comments (input) wanted. £ can- 
not be larger than $3FF. 

= 1 or 1 C is relative 

= R J £ is a number that specifies the number of words to a 

word that contains the logical unit. The £ parameter 
in this case can be positive or negative but must not 
exceed + or - $1FF. 

e. g. , READ LUN-*+3, -, -, -, -, -, -, R, - 
where LUN contains the logical unit. 

Note the restriction that when using the I option the absolute address must be 
within the range of 000 to 3FF which in most cases precludes the use of the I 
option when the location is within ones own program, except for system units. 

The following are the core locations in the operating system which contain the v 

logical unit numbers of the standard devices: 

Device Core Location 



Input comment device $FD 

Output comment device $FC 

Standard print output device $FB 

Standard binary output device $FA 

Standard input device $F9 

Mass storage library $C2 

Mass storage scratch $B3 

Each piece of equipment has a logical unit number assigned to it for the system 
to use. Also, one piece of equipment may have more than one logical unit number, 
depending on the use. It is not to be confused with the equipment number dialed 
on the controller nor with the unit number set on the unit (i. e. , tape unit). It 
could be thought of as the system number of the driver. 
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8.3.2.11 

The logical unit numbers will be different at each installation but the following 
numbers are very commonly used: 

2 - PTR 

3 - PTP 

4 - TTY 

5 - CR 

6 - MT #1 

7 - MT #2 

8 - DISK 

9 - LP, system driver 

10 - LP, FORTRAN driver 

If the programmer does not want to change the logical unit for this request, during 
his program he could specify it directly, as in the following example. 



O 



0001 
0002 

0003 0003 

0004 P0000 F001 
P0001 E001 
P0002 E002 
P0003 E003 
P0004 B005 
P0005 C004 

0005 

0005 P0006 54F4 
0005 P0007 0C01 
0005 P0008 000F P 

P0009 0000 
0005 P000A 0003 -« 
0005 P000B 0005 

P000C 0000 P 



NAM A R / W EXAMPLE A 
ENT START 
EQU PTP(03) 
BUF NUM $F001,$E001,$E002, $E003, $B005,$C004 



START FWRITE PTP,XX,BUF, 5, B, 0,1, , 

\ \ 



logical unit 



Output 




wordcount 



data 



checksum 



Note that the assembler put 0003 in the logical unit position (P000A) of the code for 
the FWRITE. Note also that only 5 of the 6 words in the buffer were written out. 



\ j 
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8.3.2.11 



See also the logical unit specification in the macro calls in the completion address 
example in section 8. 3. 2. 6. The A specified that the logical unit field (4) was ab- 
solute. 

On the other hand, if the programmer wanted to use one of the standard devices, 
such as the comment device, he would specify an indirect address in the following 
form: 



0004 




XI 


0004 


P0011 


54 F4 


0004 


P0012 


0C01 


0004 


P0013 


001A P 




P0014 
P0015 


0000 


0004 


18FC ^ 


0004 


P0016 


0011 




P0017 


0000 P 



FWRITE $FC, XB, STATEM, 17, A, 0, 1, 1, 

\ \ 



location containing LUN 



The programmer may want to change the logical unit, depending on the conditions 
in his program; therefore, he may have a location within his program in which to 
store the logical unit number. The following example would be a way to code a 
program to write one message (from M21) on a LOG unit and the COMMENTS unit, 
then write another message (from M22) on the COMMENTS unit only. The entry 
point is GO TO, and LOG is EQU'd to the LOG unit while COMMENTS is EQU'd to 
$FC. Note that the word in the program which contains the logical unit number 
must be addressed relatively because its absolute address may not fit in the 10- 
bit £ field. Note also that the completion and buffer addresses may be addressed 
absolutely in this same macro call because the x bit is not set for a relative logi- 
cal unit word. 
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0003 P0000 5448 M21 ALF *, THIS MESSAGE APPEARS ON THE LOG* 
P0001 4953 

0004 P0010 414E M22 ALF *, AND THIS ON THE COMMENTS DEVICE. * 



o 



0005 


P0020 


0001 


0006 


P0021 


0B00 


0007 






0007 


P0022 


54 F4 


0007 


P0023 


0C01 


0007 


P0024 


002B P 




P0025 


0000 


0007 


P0026 


17FC 


0007 


P0027 


0010 




P0028 


0000 P 


0008 






0008 


P0029 


54F4 


0008 


P002A 


0A00 


0009 


P002B 


1CF5 


0010 


P002C 


cooo 




P002D 


000B 


0011 


P002E 


68F1 


0012 


P002F 


58F1 


0013 


P0030 


017E 


0014 


P0031 


C0FC 


0015 


P0032 


68ED 


0016 


P0033 


58ED 


0017 


P0034 


017A 


0018 






0018 


P0035 


54F4 


0018 


P0036 


0C01 


0018 


P0037 


003E P 




P0038 


0000 


0018 


P0039 


18FC 


0018 


P003A 


0011 




P003B 


0010 P 


0019 






0019 


P003C 


54F4 


0019 


P003D 


0A00 


0020 


P003E 


0170 



LUNIT BSS LUNIT 
XI NOP 

FWRITE LUNIT-*+3, COMPLETE, M21, 16, A, 0, 1, R, 

\ \ 



relative distance to LUNIT 



EXIT 



COMPLETE JMP* (XI) 
GOTO LDA =XLOG 



STA* LUNIT 

RTJ* XI 

SQM ERROR 

LDA COMMENTS 

STA* LUNIT 

RTJ* XI 

SQM ERROR 

FWRITE $FC, OK, M22, 17, A, 0, 1, 1, 



EXIT 



OK SQM ERROR 
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What other information does the programmer need to supply the operating system 
to perform an I/O operation? The operating system needs to know how many 
words are to be transferred, where in core the information is stored for a write 
operation or, for a read, where it is to be stored. This is done by specifying the 
remaining parameters. 

8. 3. 2. 12 Number of Words 

The n parameter is the number of words requested to be transferred. A read will 
transfer one record, so if less than the requested number of words is in the 
record (i. e. , on paper tape, see 8. 3. 2. 2. 1. 2) a short read will occur. This is 
perfectly legal since it allows the programmer to specify a maximum but get the 
actual number. 

The location of the number of words can be specified in several ways: 

x n_ Meaning of n 

n n is the length of the block to be transferred; x 

has no meaning. 

e.g., FWRITE -,-,-, 6, -,-,-,-, - 

In this case 6 words would be transferred. 

=0 (n) n is indirect. 

=blank It is a core location containing the block size. 

e.g., WRITE -,-,-, (n),-, -,-,-, 
n contains the block size. 

^0 (n) n is relative. 

T^blank It is the relative distance to a core location con- 

taining the block size. 

e.g., READ -,-,-, (N-*+4),-, -,-,-, X 

N in this case contains the number of words to 

be transferred. 

See the other read/write examples for illustrations of the n parameter. 

8. 3. 2. 13 Starting Address of Buffer 



The location in core in which the data to be transferred is stored is indicated by 
the s parameter. The s refers to the first word of the data block. The buffer 
address can be specified in several ways, again in conjunction with the x bit. 
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x 

=0 
=blank 



=0 
=blank 



(s) 



^0 
^blank 



O 



7^0 

^blank 



(s) 



Meaning 



s is the starting address of the data block in 
core. 

e.g., FWRITE -,-, BUF,-,-, -,-,-, 
where BUF is the starting address. 

s is indirect. 

It is the core location that contains the absolute 

address of the data block. 

e.g., READ -, -,(BUFADR),-,-, -,-,-, 
BUF ADR contains the absolute address of the 
starting address. 

s is relative. 

s is a positive increment added to the address 
of the first word of the parameter list to form 
the starting address. 

e.g., FREAD -,-, BUF-*+5, -,-,-, -,-,X 
BUF would be the first word of the data block. 

s is double relative. 

s is a positive increment added to the address 

of the parameter list to form the address of a 

word that contains another relative indicator. 

This indicator is added to the first word of the 

parameter list to form the address of the data 

block. 

e. g. , WRITE -, -, (BUFREL-*+5), -, -, -, -, -, X 
BUF RE L contains a number to be added to the 
first word of the parameter list to locate the 
buffer. 



The above specifications mean one can specify the address directly, relatively 
or indirectly. If the buffer were within one's program and if the request were 
always going to deal with this one buffer, one could reference in one of the fol- 
lowing ways. 



o 
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0001 
0002 



0003 
0004 
0004 
0004 
0004 

0004 
0004 

0005 
0005 
0005 
0006 



P0000 

P0001 

P0002 

P0003 

P0004 

P0005 

P0006 

P0007 

P0008 

P0009 

POOOA 

POOOB 

POOOC 

POOOD 

POOOE 

POOOF 

P0010 



5448 
4953 
2049 
5320 
414E 
2045 
5841 
4D50 
4C45 
2046 
4F52 
2053 
2050 
4152 
414D 
4554 
4552 



STATEM 



NAME - R/W EXAMPLE 
ALF *, THIS IS AN EXAMPLE FOR S PARAMETER* 



XI 

POOH 54F4 

P0012 0C01 

P0013 001A P 

P0014 0000 

P0015 18FC 

P0016 0011 

P0017 0000 P **— 



ENT XI 

FWRITE $FC, XB, STATEM, 17 , A, 0, 1, 1 



\ 



P0018 54F4 
P0019 0A00 
P001A 0179 XB 



Starting Address 
EXIT 



SQM ER1 



0007 
0007 
0007 
0007 

0007 
0007 

0008 
0008 
0008 
0009 



P001B 
P001C 
P001D 
P001E 
P001F 
P0020 
P0021 



54F4 

0D01 

0009 

0000 

18FC 

0011 

7FE3 



P0022 54F4 
P0023 0A00 
P0024 181C 



FWRITE $FC, XC-*+l, STATEM- *+5, 17, A, 0, 1, 1, X 

\ \ 



ER1 



Starting Address, Relative 
EXIT 



JMP* ERROR 
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The second example shows that even though the relative address must be in the 
positive direction the data block can come before the r eques t in the program. 
This makes use of the wrap-around feature of the machine's 15-bit address arith- 
metic. 

1C + 7FE3 = 7FFF, which is a zero in 15 bits, indicating P0000. 

If, on the other hand, the r eques t may be used to read or write a number of 
data tables, an indirect method might be used. 



0010 


P0025 COOO XC 




P0026 0000 P 


0011 


P0027 6818 


0012 




0012 


P0028 54F4 


0012 


P0029 0C01 


0012 


P002A 0031 P 




P002B 0000 


0012 


P002C 18FC 


0012 


P002D 0011 




P002E 803F ■*. 



LDA =XSTATEM 



o 



STA* PT 

FWRITE $FC,XD, (PT), 17, A, 0, 1, 1, 

\ \ 



0013 

0013 P002F 54F4 
0013 P0030 0A00 



Starting Address, Indirect 
EXIT 



0014 


P0031 


017C 


XD 


SQM ER2 


0015 


P0032 
P0033 


COOO 
7FC9 




LDA =XSTATI 


0016 


P0034 


680B 




STA* PT 


0017 






EX 


FWRITE $FC, 


0017 


P0035 


54F4 






0017 


P0036 


0D01 






0017 


P0037 
P0038 


0006 
0000 






0017 


P0039 


18FC 






0017 


P003A 
P003B 


0011 
8009 






0018 






EC 


EXIT 


0018 


P003C 


54F4 






0018 


P003D 


0A00 






0019 


P003E 


1802 


ER2 


JMP* ERROR 


0020 


P003F 


0001 


PT 


BSS PT 
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8. 3. 2. 14 Setting Up RW requests in Background 

Jobs are supposed to run at priority and their completion routines are supposed 
to run at priority 1. There are three ways the input/output requests can be set 
up (for jobs) to maintain control in the program. 

1. Looping on the thread word 

2. Looping on a flag set by the completion routine 

3. Scheduling out of the completion routine 

The example to use would be an input of a card buffer which would then be written 
on the teletype. 

8. 3. 2. 14. 1 Looping on the Thread Word 



THR 



WAIT 



RTJ- 


($F4) 




NUM 


$0801 


FREAD 


NUM 





NO COMPL 


NUM 







NUM 


$1002 


ASCII, PTR 


NUM 


35 


35 WORDS 


ADC 


BUF 




LDA* 


THR 




SAZ 


WRITE-*-l 




JMP* 


WAIT 





WRITE 



The thread word will be non-zero until the input is finished; then the buffer can be 
written out. This technique hangs the computer in a loop and locks out any lower 
priority operations. Of course, a job is running at so this will not matter. 
However, this method should not ever be used in foreground programs. 



8. 3. 2. 14. 2 Looping on a Flag 



WAIT 



WRITE 



Flag 


($F4) 




RTJ- 




NUM 


$0801 


FREAD 


ADC 


COMPL 


COMPL 


NUM 







NUM 


$1002 


ASCII, PTR 


NUM 


35 


35 WORDS 


ADC 


BUF 




LDA* 


FLAG 




SAN 


WRITE 




JMP* 


WAIT 




ENA 







STA* 


FLAG 
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8.3.2.14.2 



COMPL 



ERR 



ERR-*-l 

1 

FLAG 



~\ 



> Closed Routine 



JMP* COMPL+1 

FLAG BSS FLAG(l) j 

This method does the same thing as looping on the thread word, except it provides 
for a completion routine where errors can be checked. It should not be used in 
the foreground either because it locks out priorities lower than the completion 
priority. 

8. 3. 2. 14. 3 Scheduling Out of the Completion Routine 



O 



This method may 


be used 


only under MSOS. 






RTJ- 




($F4) 






NUM 




$0801 


FREAD 




ADC 




COMPL 


COMPL 




NUM 











NUM 




$1002 


ASCII, PTR 




NUM 




35 


35 WORDS 




ADC 




BUF 


BUFFER ADDR 




EXIT 








COMPL 


SQP 
RTJ* 




OK-*-l 
ERR 


CHECK ERROR 


OK 


SCHDLE 


WRITE, 0,0 


SCHEDULE WR 




EXIT 









WRITE 



This method provides for an exit immediately after the request is initiated at 
priority 0, to wait for completion. When the completion routine is entered at 
priority 1, a check is made for errors and then a schedule request is made for 
the address WRITE to be entered at priority 0, after the completion routine does 
its exit. (The schedule request is covered in the next section. ) 

Scheduling out of the completion routine is a good method to learn to use because 
it can be used by either background or foreground programs, it maintains a 
priority scheme if it is desired that the I/O completion routines run at a different 
priority from the main body of the program (either higher or lower), and it does 
not lock out lower priority operations. 

Any coding which can be done in the program before the data is needed can be 
inserted after the ADC BUF and before the EXIT. That coding will run at priority 
0, the priority of the main body of the program. 
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8.3.2.14.3 



A method similar to this is often used; it works in the background but does not 
maintain any priority scheme: 








RTJ- 


($F4) v 








NUM 


$0801 








ADC 


COMPRD 








NUM 





> 


Initiate Read 




NUM 


$1002 








NUM 


35 








ADC 


BUF y 






EXIT 






COMPRD 


SQP 


WRITE- *+l 






RTJ* 


ERR 




WRITE 


RTJ- 

NUM 


($F4) v 
$0C01 








ADC 


COMPWR y 


Initiate Write 




NUM 











NUM 


$1004 








NUM 


35 








ADC 


BUF / 








EXIT 






COMPWR 


i 









In the above example, the read is initiated at priority 0. When the first comple- 
tion routine is entered, COMPRD, the priority would change to 1 and would never 
drop back to during the remainder of the program. Therefore, the write will 
be initiated at 1, not 0. However, if it were desired to have completion routines 
run higher, the cp in the write r eque s t would have to be 2 (illegal in jobs) and 
each subsequent request would have to have a higher completion priority. This 
would be rather sloppy in the foreground. 

This method could not be used under the utility system because interrupts would 
be locked out at the beginning of the first completion routine. The schedule 
method could not be used under utility either, because the s chedule request is 
not available under utility. 

8. 3. 2. 15 Examples of Programs Using I/O Requests 

The following two programs read one card into a buffer (BUF) from the card 
reader, logical unit 12. They then print the card on the teletypewriter. The 
first program uses system macro requests; the second program codes the system 
calls. 



^ 
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a 

I 

« t-i 
O 



o 



8.3.2.15 



JOB 



0001 
0002 
0003 
0004 
0005 
0006 
0007 
0008 
0009 
0009 
0009 
0009 

0009 
0009 

0010 
0010 
0010 
"0011 
0012 
0013 



NAM CARD TO PRINT 

*THIS PROGRAM USES SYSTEM REQUESTS TO READ AND WRITE 



P0000 0028 



BUF 



ENT START, PRINT 

EXT IOERR -* error subroutine 

BSS BUF(40) -m data buffer 



54 F4 

0801 

0031 P 

0000 

100C 

0028 

0000 P 



P0028 
P0029 
P002A 
P002B 
P002C 
P002D 
P002E 

P002F 

P0030 

Read completed 

P0031 0162 ^COMPRD 

P0032 5400 X 

P0033 7FFF X . 



54F4 
0A00 



START FREAD 12, COMPRD, BUF, 40, A, 0, 1, , Formatted Read Macro 

' t t 1 ttt ♦ 

LUN 12 COMPL | I X bit = 

ADDR Buffer CP = 1 

RP= 

ASCII mode 

40 words 

Read is initiated 



EXIT 

Jump to dispatcher (EXIT Request) 

No work to do until Read completed 



EXIT Macro 




SQP 
RTJ 



SCHPRT 
IOERR 



Q15 
Q15 



if no Read error 

1 if error 



SCHPRT SCHDLE PRINT, 0,0 

Schedule PRINT at \ X bit = 

priority before exit RP = 

from completion routine 



Schedule Macro 



EXIT 
Jump to dispatcher at end of completion 
Dispatcher will now go execute PRINT at priority 



PRINT 



FWRITE $FC, COMPPR, BUF, 35, A, 0, 1, 1, Formatted Write Macro 



Contains 
LUN 



t 

COMPL 
ADDR 

Buffer 



Write is initiated 



* ♦MtxMt^ 

Indirect bit for LUN 
CP= 1 
RP= 
ASCII mode 
35 words (on TTY) 



EXIT 
Jump to dispatcher 
No work to do until Write completed 



EXIT Macro 



a 
S J 

o " 
O 



0019 
0020 
0021 

0022 
0022 
0022 
0023 



P0042 0162 
P0043 5400 X 
P0044 0033 X 



COMPPR 



SQP 
RTJ 



FINI , 
IOERR 



NO IO ERR 



P0045 
P0046 



54F4 
0A00 



FINI 



EXIT 



EXIT Macro 



Entry points 



SCHPRT 



00FF START 
0034P COMPPR 



0001 

0002 

0003 P0000 18FF 

0004 



IOERR 



END 



0028P PRINT 
0042P FINI 

NAM 

ENT 



NUM 

END 



START 



0039P BUF 
0045P IOERR 

IOERR 

IOERR 



$18FF « 



0000P COMPRD 0031P 
0044X 



I/O subroutine 

Hang instruction used for 
checkout 



CARD 
IOERR 



2210 
2257 



where pgms loaded 



00FF IOERR 0000P 



o 
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8.3.2.15 



Reads and writes initiate I/O. Control returns to next instruction in program before I/O 
is done. Job I/O is done at priority 0. Program should not loop waiting for I/O to be 
done. 

Completion address is entered when I/O is done, at priority 1. It should be short and 
exit to dispatcher. Check Q for I/O errors. 

This JOB does not check Q after Request, to see if Request accepted (Q15 = 0). Jobs do 
not have to but system programs must. 



^wwvww- 



TTY Printout 
*p 

J 

*ASSEM 

J 
*p 

J 

*L,8 
J 

*X,,A 

THIS PROGRAM WORKS ON THE 1700 COMPUTER SYSTEM UNDER MSOS 2. Formatted Write 
J 



-No MAP 



For program checkout, hang instruction could also be used to see if completion routine 
entered. 



0019 * 

0020 P0042 0172 COMPPR 
0021 

0021 P0043 54F4 

0021 P0044 0A00 

0022 P0045 18FF HANG 
0023 



SQM 


HANG 


EXIT 




NUM 


$18FF 


END 


START 



c 
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8.3.2.15 



EXAMPLE READ/WRITE PROGRAM 



JOB 



0001 






0002 






0003 






0004 




00EA 


0005 


P0000 


0000 


0006 


POOOl 
P0002 


54 F4 


0007 


0201 


0008 


P0003 


0009 


0009 


P0004 


0000 




P0005 


100C 


0010 


P0006 


0028 


0011 


P0007 


001F 



o 



0013 
0014 

0015 
0016 
0017 
0018 
0019 



0020 
0021 
0022 
0023 



0024 



NAM 


CARD TO PRINT 


ENT 


START, PRINT 


EXT 


IOERR 


EQU 


ADISP($EA) 








RTJ- 


($F4) 


NUM 


$0201 


ADC 


COMPRD -« 


NUM 


0, $100C 


NUM 


40 


ADC 


BUF 



START 

Initiate FREAD 
READ, CP = 1 RP = 
Completion Address 
THREAD, LUN CR = 12, ASCII 

ONE CARD TO READ 
FWA BUFFER AREA 

Control returns beneath parameter string after Read is initiated. If program has 
nothing to do, it should exit until completion routine is entered. Unprotected program 
can exit to dispatcher. 



0012 P0008 14EA 



JMP- 



(ADISP) 



When Read is finished control will go to completion address COMPRD. Completion 
routine should check bit 15 of Q for I/O errors and exit to dispatcher. 



P0009 0162 
P000A 5400 X 
P000B 7FFFX 
P000C 54F4 
P000D 



COMPRD 



SCHPRT 



P000E 



P000F 54F4 



1200 
0011 



P0010 0A00 



SQP 
RTJ 

RTJ- 

NUM 
ADC 
RTJ- 

NUM 



SCHPRT 
IOERR 

($F4) 
$1200 
PRINT 
($F4) 
$A00 



Schedule PRINT at priority 
before exit, to drop priority 
back to 0. 

EXIT REQUEST 



Dispatcher will pass control to Print after read completion routine exit. 
PRINT 



P0011 54F4 



P0012 


0401 


P0013 


001A 


P0014 


0000 


P0015 


1009 


P0016 


0023 


P0017 


001F 



RTJ- 

NUM 
ADC 

NUM 



ADC 



($F4) 

$0401 PRINT, CP = 1 RP •= 

COMPPR COMPLETION ADDRESS 

0, $1009,35 

35 words on TTY 



BUF 



FWA BUFFER 



Control returns here after print is initiated. Exit Request is same as jump to dis- 
patcher. 



After print is done, control goes to COMPPR at priority 1. Here exit from program. 
COMPPR 



0025 


P0018 54F4 


0026 


P0019 |0A00 




After print is d 


0027 


P001A 0162 


0028 


P001B 5400 X 




P001C 000B X 


0029 


P001D 54F4 


0030 


P001E 0A00 


0031 


P001F 0028 


0032 





RTJ- 

NUM 



($F4) 
$A00 



FINI 



BUF 



SQP 
RTJ 

RTJ- 

NUM 

BSS 

END 



FINI 
IOERR 

($F4) 
$0A00 
BUF(40) 
START 



EXIT WHEN THRU 
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TTY Printout. Read/Write Program 

Not using system macros. 

Coding requests as in example will produce much faster assembly time than when using 
macros. 




The E message noted unpatched externals (IOERR). The * (CR) typed by operator 

said to ignore them. 

TCH=IS~ PROGRAM WORKS ON THE 1700 COMPUTER SYSTEM UNDER MSOS 2.0 
J >v ^ 



^ output from WRITE 

Unformatted Write did not do line feed as there are no line feed/CR in unformatted Write. 

Formatted Write should be used on print devices such as TTY and LP. 

Unformatted Write on printer does not work correctly. The printer buffer is filled but 
the line is not printed until the next output line is sent to the printer. 
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8. 3. 2. 15 

Read formatted ASCII data records from paper tape into BUF area and type it out. 
Assume the BUF area is larger than the formatted record. Continue until the 
reader runs out of tape, giving an error. 



O 





NAM 










ENT 


BEGIN 








BSS 


BUF(30),STAT(1) 


FLAG 


ADC 







Flag for switching 


BEGIN 












START 


CLE 


A 








STA* 


FLAG 




Clear flag 


READIT 


RTJ- 


($F4) 




Format read LU2 is paper tape 




NUM 


$800 




reader where to go when fin- 




ADC 


READY 




ished 




NUM 


0, $1002, 


30 






ADC 


BUF 








LDA* 


FLAG 




Hang until flag set by comple- 




SAN 


1 




tion routine 




JMP* 


*-2 








LDQ 


STAT 








SQP 


MORE-* 


-1 






RTJ- 


($F4) 




Exit request on input error- 




NUM 


$A00 




end job 


MORE 


CLR 


A 




Clear flag 




STA* 


FLAG 




Hang until flag set by comple- 




RTJ- 


($F4) 




tion routine. Type out format 




NUM 


$coo 








ADC 


READY 








NUM 


0, $1004, 


30 






ADC 


BUF 








LDA* 


FLAG 








SAN 


1 








JMP* 


*_2 








JMP* 


START 






READY 


RAO* 


FLAG 




Completion routine sets flag 




STQ 


STAT 




Exit back to program 




RTJ- 


($F4) 








NUM 


$A00 
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8. 3. 3 Schedule Request - Request Code 9 

The schedule request is available only under MSOS. 

Programs occur in the 1700 run at 16 different priorities, 15 (high) to (low). A 
program can schedule a section of coding to be executed at a certain priority level. 
The address of the scheduled coding can be either in the scheduling program, 
external to it, or in the system. 

If the desired priority of the scheduled program is higher than the running priority 
of the scheduling program, a pseudo interrupt occurs and the scheduled program 
is executed immediately, hi this way a schedule request can be considered a 
jump that also changes the running priority. Control will return to the "inter- 
rupted" program when the scheduled program exits. 

If the desired priority of the scheduled program is not higher, it is threaded onto 
a queue of programs waiting to be executed, in order of priority. In this way one 
program may schedule another to be executed at a different priority after the 
scheduling program exits. 

Background programs can be scheduled to run at levels and 1 only. 

A parameter may be passed in the requestor's Q regis ter to the program being 
scheduled. 



8. 3. 3. 1 Format of Schedule Request 



REQ 



} 






RTJ- 










($F4) 






15 



14 






1 


9 
1 


8 

X 


7 







4 



3 


P 





c 
Completion Address 



re request code, 6 bits: 9 

x relative/indirect indicator, 1 bit: or 1 

rp this field is ignored by the scheduler 

p priority, 4 bits: 0-15 

c address of program scheduled 



The macro call is: 
REQ 



SCHDLE 



c,p,x 



REQ will be on the 54F4, which will be generated by the macro. REQ+1 is the 
first word of the parameter strings 



r 
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8.3.3.1 



An example of a coded call would be: 



RTJ- 

NUM 
ADC 



($F4) 
$1201 
PGM 



(schedules PGM at priority 1) 

8. 3. 3. 2 Request Code 

This field is always 9 for schedule requests. 



8.3.3.3 XBit 



The x bit is used in conjunction with the c parameter. It will be discussed as it 
relates to this parameter. 



8.3.3.4 Priority 



The p field is the priority at which the programmer desires to run the scheduled 
program. The priority may be greater than, equal to or less than the program 
that schedules it. However, in the background it is always or 1. 



O 



8.3.3.5 Address 



The c field contains the address of the program being scheduled. The x parame- 
ter determines the forms the c may take as it did for the c parameter of the 
read/write requests. 



x 



or blank 



^0 
T^blank 



(c) 



The meaning of c 

c is the address. 

i.e., SCHDLE PGM, -, - 

PGM is assembled as an absolute address (pro- 
gram relocatable). 

c is relative. 

c is a positive increment added to the address 
of the first word of the parameter list to locate 
the address. 

i.e., SCHDLE PGM-*+l,-,X 

In this example PGM is the address. 

c is an index to the system directory. The ( ) 
set bit 15. x has no meaning. 
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8.3.3.5 



Note that there is no indirect form and that the option (c) cannot be used in the (^_ 

background because programs in the system library may not be scheduled from 
the background; see Chapter 11. 

8. 3. 3. 6 Example of Schedule Request 

The following example program writes one message from program SCHEDULE 
and then schedules TWO (the entry point in program NEXT) to run at priority 1 
and write another message. 



8-38 



8. 3. 3. 6 



0001 








0002 








0003 








0004 


P0000 


4558 


MA 




P0001 


414D 






P0002 


504C 






P0003 


4520 






P0004 


4E4F 






P0005 


2031 






P0006 


2E20 




0005 






XA 


0005 


P0007 


54F4 




0005 


P0008 


0C01 




0005 


P0009 


0010 P 






POOOA 


0000 




0005 


POOOB 


1004 




0005 


POOOC 


0006 






POOOD 


0000 P 




0006 








0006 


POOOE 


54F4 




0006 


POOOF 


OAOO 




0007 






XB 


0007 


P0010 


54F4 




0007 


POOH 


1201 




0007 


P0012 


7FFFX 




0008 








0008 


P0013 


54F4 




0008 


P0014 


OAOO 




0009 








I 




OOFF 


XA 



0001 






0002 






0003 


POOOO 


4558 




P0001 


414D 




P0002 


504C 




P0003 


4520 




P0004 


4E4F 




P0005 


2E20 




P0006 


3220 


0004 






0004 


P0007 


54F4 


0004 


P0008 


0C01 


0004 


P0009 


0010 P 




POOOA 


0000 


0004 


POOOB 


1004 


0004 


POOOC 


0007 




POOOD 


0000 P 



NAM SCHEDULE 

ENT XA 

EXT TWO 

ALF *, EXAMPLE NO 1. * 



FWRITE 4, XB, MA, 6, A, 0, 1, A 



MB 



EXIT 

SCHDLE TWO, 1 

EXIT 

END XC 
0007P MA 00O0P XB 0010P TWO 

NAM NEXT 

ENT TWO 

ALF *, EXAMPLE NO. 2* 



0012X 



TWO 



FWRITE 4, XC, MB, 7, A, 0, 1 



0005 

1 ENTRY POINT TABLE- 

XA 2E2F TWO 

J 

*X 

EXAMPLE NO 1. 

EXAMPLE NO. 2 



EXIT 



2F44 
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8, 3. 4 TIMER Request - Request Code 8 

The timer request is available only under MSOS. 

Ahardware timing device such as the 1573 timer is required for the timer request 
to work since there is no real time clock in the CPU. 

The timer request is a scheduled request where the program is scheduled after a 
predetermined time delay. The delay allowed will be from 1/60 second to 32, 767 
minutes. 

Parameters c,p, and x are specified as for the SCHDLE request. However, instead 
of a parameter a time delay is specified inQ when the request is made. The delay 
is specified in multiples of the basic unit of the timing device. The timer passes 
the current contents of the core clock (E8) to the scheduled program in Q. 

Timer requests are stacked in the s chedule request stack but are not threaded 
with them. Instead, they are threaded together on the basis of time until activa- 
tion. When the delay for a timer request has expired, a SCHDLE request is made 
by the system and the request is rethreaded into the SCHDLE thread. 

The timer request is normally made by protected programs but it can be made by 
jobs at levels or 1. 

The timer was different under MSOS 1.0. 
8. 3. 4. 1 Format for the | TIMER Request 







RTJ- 


($F4) 














15 



14 


rc 

8 


9 


8 

X 


7 


u 
0-3 


4 


3 


P 
0-15 





c 


Q 



re request code, 6 bits: 8 

x relative/indirect indicator, 1 bit: or 1 

u type of units desired, 4 bits: to 3 

p priority, 4 bits: 0-15 

c address of program to be scheduled 

Q number of units desired: 1-32, 767 
must also be in Q register 

The macro form for this request is: 

TIMER c,p,x,Q,u 
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o 



8.3.4.1 
An example of a coded call would be: 



LDQ 


=N$0005 


RTJ- 


($F4) 


NUM 


$1024 


ADC 


PGM 


NUM 


5 



(schedule PGM in 5 seconds to run at priority 4) 
3. 4. 2 Request Code 



Request code is 8. 
3.4.3 XBit 



The x bit is used in conjunction with the c parameter. It will be discussed as it 
relates to this parameter. 



8.3.4.4 Units 



The type of units requested is specified based on the basic unit of the timing 
device. 

u 

^ basic units: 60/sec on 1573 

CJ) 1 1/10 second 

2 seconds 

3 minutes 

The units field is used in conjunction with the Q parameter to calculate the desired 
time delay and it controls the precision required in the timing. 

8.3.4.5 Priority 

This is the priority at which the scheduled program is to run. It follows the same 
rules as in a schedule request. 

8.3.4.6 Address 

The c field contains the address of the program being scheduled and it follows the 
same rules as for a schedule request. 

8. 3. 4. 7 Q parameter 

The Q parameter is the number of the type of units desired; it must be in the Q 
register and the Q word of the request. 
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8.3.4.7 



For example, a timer request for 5 seconds could be either u=2 and Q=5, or u=l 
and Q=50. If u=2, the request will be on the seconds thread and will be scheduled 
in at least 5, but less than 6, seconds. If u=l, the request will be on the 1/10 
second thread and will be s cheduled in at least 5 seconds, but less than 5 1/10 
seconds. This is how the desired timing precision can be achieved. 



C 



8. 3. 4. 8 Example of (TIMER Request 

Assume the basic unit of the system is 1/60 second. Schedule the program PGM 
using an absolute call, after 20 minutes has elapsed, to run at priority 6. 



ENQ 
TIMER 



20 

PGM, 6,, 20, 3 



8. 3. 5 STATUS Request - Request Code 3 

This request is available to unprotected programs only. Foreground programs do 
not use the status request to obtain status. 

The status of a particular read/write request is obtained with the status request. 
The status of the request is returned in the A, Q, and I registers. 

The status request can be used to determine whether an I/O operation is complete, 
to examine the type of hardware to which the logical unit is assigned, to check the 
dynamic status on the hardware, or to find out how far along thel/O is by checking 
the current buffer address. 

8. 3. 5. 1 Format of the STATUS Request 









RTJ- 














($F4) 








15 



14 






rc 



9 
1 1 


8 

X 


7 






















15 









12 



11 


10 

A 


9 






LUN 















address 


ap 
; of parameter list 















re request code, 6 bits: 3 
x relative/indirect indicator, 1 bit: or 1 

£ logical unit, 10 bits; modified by a, same as for read/write requests 
a logical unit address indicator, 2 bits; same as for read/write requests 
Settings are: 

a = blank =00: fi is the logical unit number 
a = R =01: £ is a signed Increment (+1FF) 
a = I =10: £ is a core address (0<£<3FF) 

ap address of parameter list of request 
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o 



8.3.5.1 

The macro call is: 

STATUS £ , ap, a, x 

An example of a coded call would be: 



RTJ- 


($F4) 


NUM 


$0600 


NUM 


0004 


ADC 


REQ+1 



(Obtain status of a request on logical unit 4; request address is REQ+1) 
!. 3. 5. 2 Request Code 



The request code is 3. 
8.3.5.3 XBit 



The x bit is used in conjunction with the ap parameter and will be discussed as it 
relates to that parameter. 

8. 3. 5. 4 A Field 

The a bits modify the logical unit field in the same way as in the I/O request. 

8. 3. 5. 5 Logical Unit 

The logical unit is the same logical unit upon which the I/O request was made 
(the one we wish to have the status of). The logical unit may be specified directly, 
indirectly or relatively, in the same way the logical unit was specified in the I/O 
request. 

8. 3. 5. 6 Address of Parameter List 

The ap field is the address of the parameter list for the request for which status 
is desired. It can be specified directly, indirectly or relatively, in conjunction 
with the x bit. 

x ap Meaning of ap 



=0 or blank ap ap is the address of the first word of the para- 

meter list of the I/O request. 

i.e., STATUS -, REQ+1, -,- 
REQ+1 is the parameter address. 

^0 ap ap is relative. 

^blank ap is a positive increment added to the address 

of the first word of the status request parameter 
list to obtain the address of the first word of an 
input/output request parameter list. 
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x ap Meaning of ap 

i.e., STATUS -,REQ+l-*+2,-,X 
REQ+1 is the parameter address. 

=0 (ap) ap is indirect 

=blank ap is the address of a location containing the 

address of the first word of an input/output 

parameter list. 

i.e., STATUS -, (REQADR), -,- 
REQADR contains the address of REQ+1 

7^0 (ap) ap is double relative. 

T^blank ap is a positive increment added to the address 

of the first word of the status request parameter 
list to obtain the address of a location containing 
another positive increment. The second incre- 
ment is added to the address of the first word of 
the status request parameter list to obtain the 
address of the first word of an input/ output re- 
quest parameter list. Because of wraparound 
in adding, both increments may refer to loca- 
tions ahead of or behind the status request. 

i.e., STATUS -, (REQREL-*+2), -,X 
REQREL contains a number to be added to the 
first word of the status parameter list to form 
the distance to REQ+1 (s+1+contents of REQREL). 

Although the parameter/ address is not needed in the utility system, it is supplied 
to be compatible with 1700 MSOS. If it is omitted, only device status will be re- 
turned. 

8. 3. 5. 7 Reply to STATUS Reques t 

Following execution of the status request, the A, Q, and I registers contain the 
status. The content of these registers is as follows: 

A: hardware status of device 
Q: word 8 of Physical Device Table for device 
I: last core address of data transmission 



C 
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5.3.5.7.1 



8. 3. 5. 7. 1 Hardware Status 



A 



Hardware Status Reply 



The hardware reply is dynamic unless the device is connected to a buffered data 
channel and the channel is busy. If it is not busy, the hardware reply is the status 
obtained at the completion of the last request for that device. For an explanation 
of hardware replies refer to the hardware specifications. 

This status is the hardware reply bits on the device itself. 



8.3.5.7.2 Word 8 of PPT 

See appendix D of the MSOS Reference Manual for contents of this word. 

15 14 13 11 10 4 3 1 

Q 



E 


S 


T 


R 


P 



Word 8 



O 



EREQST 
Request Status 
Bits 




Device not available to unprotected programs 

Device may be read from unprotected programs 

Device may be written by unprotected programs 

Equipment table includes words 18-33 for message 

buffering 

Equipment type constant (T), see T table 

Equipment Class, see S table 

Device failure 
Operation is in progress 
Operation is complete 



S TABLE 



EQUIPMENT CLASS CODES 
Word 8, EREQST Bits 11-13 



Class not defined 
Magnetic tape device 
Mass storage device 
Card device 
Paper tape device 
Printer device 
Teletype device 
Reserved for future use 
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T TABLE 

STANDARD EQUIPMENT TYPE CODES 
Word 8, EREQST Bits 4-10 



1711/1713 Teletypewriter 

1 1721/1722 Paper Tape Reader 

2 1723/1724 Paper Tape Punch 



v Unas signed 

5 1738/853 Disk Unit 

6 1751 Drum Unit 

7 1729 Card Reader 

8 1738/854 Disk Unit 

9 601 Magnetic Tape Unit 

10 Software Buffering Device 

11 1742 Line Printer 

12 1728/430 Card Reader/Punch 

13 Software Core Allocator 

14 210 CRT Display Station 

15 1558 Latching Relay Output 

16 1553 External Register Output 

17 311B/312B Data Set Terminal 

18 322/323 Teletype Terminal 

19 Unassigned 

20 166 Line Printer 

21 1612 Line Printer 

22 415 Card Punch 

23 405 Card Reader 

24 608 Magnetic Tape Unit 

25 609 Magnetic Tape Unit 

26 1713 Teletype Keyboard 

27 1713 TTY Paper Tape Punch 

28 1713 TTY Paper Tape Reader 

29 Unassigned 

30 1797 Buffered I/O Interface 

31 Software Dummy Alternate 

32 1584 Selectric I/O Typer 

33 1582 Flexowriter I/O Typer 

34 1716 Coupling Data Channel 

35 1718 Satellite Coupler 

36 Unassigned 

37 8000 Series Magnetic Tape Unit 

38 ] 

39 J 

40 1530 A/D Converter 30/40 PPS 

41 1534 A/D Converter 200 PPS 

42 1538 A/D Converter High Speed 

43 .~j 

44 J 

45-99 Reserved for future standard equipment 

100-127 Open for user assignment 
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Unassigned 



Unassigned 



J 



8.3.5.7.2 

The word 8 status can be used to determine several things about the device. The 
E field can be used to see if any request is active on the device and whether a 
hardware error is present; this requires operator intervention. T can be used to 
find out what kind of equipment the device is. For example, a program could see 
if the standard output device is a teletypewriter or a line printer and then output 
either 70-character lines or 136-character lines. The P and R fields can be used 
to determine the availability to jobs. 

8. 3. 5. 7. 3 Current Buffer Address 



I 



address 



The address of the last word that was stored in the buffer or written from the 
buffer is in the I register. In this way a job can determine how much of its buffer 
has been filled during operation. 



8. 3. 5. 8 Example of Status Request 



0015 








AA 


FWRITE 


0015 


P008F 


54F4 








0015 


P0090 


0C01 








0015 


P0091 
P0092 


OOAl 
0000 


P 






0015 


P0093 


18FC 








0015 


P0094 


8053 


P 








P0095 


8052 


P 


XA 


EXIT 


0022 








OUT 


SQP 


0022 


P009C 


54F4 






STATUS 


0022 


P009D 


0600 








0022 


P009E 


80FC 









$FC, XA, (ADDR), (LENGTH), A, 0, 1, 1 



OK-*-l 
$FC,AA+1,I 



OK 



EXIT 



The above example takes status on the request from the completion routine if an 
error indication is present. 

More examples of status requests are in the CKASSM routine, section 8. 3. 10. 

8. 3. 6 GTFILE Request - Request Code 13 

This request is available only to background programs and only under MSOS. 

A permanent file that has been placed in the program library* can be accessed 
during execution by the GTFILE request. A file is brought into core as it appears 
on the mass storage device; GTFILE does not load a program. Ifaprogramis 



*A file is placed in the program library by a LIBEDT operation. 
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8.3.6 



placed in the program library as a file, it must be in its abs olu te binary form. 
Data files cannot be changed and written back on the library during execution. 
GTFILE only reads the file into core. 

8. 3. 6. 1 Format of GTFILE Request 



RTJ- 



($F4) 



15 



14 






re 
1 


1 


9 
1 


8 

X 


7 

TO 


4 


3 


CD 





c 
completion address 


thread 


V 



m 


2 
a 


$C2 

S. 


wl 


s 
starting core address 


w2 


f 
filename address 



rc request code, 6 bits: 13 

x relative indicator 

rp request priority (for MSOS), 4 bits: 

cp completion priority, 4 bits: 1 

c completion address 

thread for system: 

v error bits, 3 bits 

m mode, 1 bit: * 

a logical unit modifier, 2 bits: 2 * 

£ logical unit address of MS device, 9 bits: 

wl first word desired in file 

s starting core address for buffer 

w2 last word desired in file 

f filename address 



$C2 



The macro call is: 

GTFILE c,f, s,wl,w2,x, rp, cp 



'Set by assembler if macro call used. 
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8.3.6.1 



o 



An example of a coded call would be: 



FILNAM 


ALF 

I 

RTJ- 


*,FILE * 


FILE NAME 




($F4) 






NUM 


$1A01 






ADC 


GOT 


COMPL 




NUM 









NUM 


$08C2 


BINARY, LIBUNIT 




NUM 





WHOLE FILE WANTED 




ADC 


BUF 


BUFFER 




NUM 









ADC 


(FILNAM) 


ADDR OF FILE NAME 



(The file FILE is requested to be stored in BUF. GOT is the completion address. ) 
8. 3. 6. 2 Request Code 



Request code is 13. 
1.3.6.3 XBit 



The x bit is used in conjunction with the f parameter. It will be discussed as it 
relates to that parameter. 

8. 3. 6. 4 Request Priority 

The request priority is always in the background for jobs. It will be used as the 
request priority for the mass storage driver when it reads in the file. 

8. 3. 6. 5 Completion Priority 

The completion priority is always 1 in the background. 

8. 3. 6. 6 Completion Address 



c is for the completion address and takes the same form as for the read/write 
request. 

8.3.6.7 Mode 

The mode field must be set to (binary). 

8. 3. 6. 8 A Field 



The a bit, logical unit modifier, must be set to 2 (indirect). 
I. 3. 6. 9 Logical Unit 



The address of the library logical unit, $C2, must be set in this field. 
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8.3.6.10 



8.3.6.10 Word Addresses: wl, w2 

wl and w2 are the beginning and ending word addresses (mass storage) within the 
file if word addressing is used and the disk word driver is present in the system. 

If only a portion of a file is wanted, the wl, w2 specifies the words wanted. They 
are specified directly. If the complete file is wanted, wl and w2 should be left 
blank. 

GTFILE -,-,-, 10,45, -, - 

GTFILE -, -,-,,,-,- 

hi the first example words 10 to 45 would be brought in. hi the second, the com- 
plete file would be brought in. 

8. 3. 6. 11 Starting Core Address 



s is the starting address of the block into which the file or a portion of the file is 
to be transferred, x determines the type of addressing mode s takes. 



x 



=0 
=blank 



^0 
^blank 



s 
s 

(s) 



(s) 



Meaning of s 

s is the starting address; x has no meaning. 

e.g., GTFILE -, -, BUF, -,-,-,-, - 

s is indirect. 

s is the core location which contains the starting 

address of the block. 

e. g. , GTFILE -, -, (BUFADR), -, -, -, -, - 

hi this case BUFADR contains the address of 

the block. 

s is relative. 

s is a positive increment added to the first word 
of the parameter list to form the s tar ting ad- 
dress of the block. 

e. g. , GTFILE -, -, (BUF-*+5), -, -, X, -, - 
BUF is the buffer. 



8. 3. 6. 12 File Name Address 

The f parameter indicates the address of the first word of a three-word block 
that contains the ASCII name of the file. It takes two forms, f and (f). 

f is a positive increment to be added to the first word of the parameter list when 
it stands alone. 
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8.3.6.12 

For example: 

GTFILE -,NAME-*+7, -,-,-,-,-,- 

In this case NAME would contain the first two characters of the ASCII name and 
the relative distance to NAME would be assembled into the macro. 

(f) indicates f is the addr es s of the three word block containing the ASCII name. 

For example: 

GTFILE -, (NAME), -, -, -, -, -, - 

hi this case the address of NAME is assembled into the macro. 

The system searches the program library for the file with the specified name. 

It is supposed to be necessary to specify two additional words at the end of the 
request in which the system will return the actual sector address of the file. 
This does not work, however, so we omit it. 

8. 3. 6. 13 Example of a GTFILE Request 

The following example uses a GTFILE request to obtain a file named SYSINI from 
the program library and store it into a buffer, beginning at $6000 (absolute ad- 
dress). 

It happens that in this example the GTFILE request is to obtain a file that is an 
absolute program and is to transfer control to it; but the GTFILE could simply 
have been used to input data to a buffer. 

The example shows how the GTFILE works and how it is assembled. 
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EXAMPLE USING GTFILE REQUEST FOR SYSTEM INITIALIZER 



0001 
0002 
0003 



0004 



0005 
0006 
0007 
0007 
0007 
0007 

0007 



0007 

0008 
0008 
0008 
0009 
0009 
0009 
0010 
0011 
0011 
0011 
0011 

0011 
0011 

0012 
0012 
0012 
0013 
0014 
0015 
0015 
0015 
0016 



P0000 
P0001 
P0002 
P0003 
P0004 
P0005 

P0006 

P0007 
P0008 
P0009 
P000A 
P000B 
P000C 
P000D 
P000E 
P000F 



5359 
5349 
4E49 
5349 
2049 
4E20 
6000 
0000 

54F4 

1A01 

0014 P 

0000 

08C2 

0000 

6000 

0000 

8000 P 



P0010 54F4 
POOH 0A00 

P0012 54F4 
P0013 OAOO 
P0014 017B 

P0015 54F4 
P0016 0C01 
P0017 001E P 
P0018 0000 
P0019 18FC 
P001A 0003 
P001B 0003 P 

P001C 54F4 
P001D OAOO 
P001E 0171 
P001F ICED 

P0020 54F4 
P0021 OAOO 



NAM 

ENT 

FILNAM ALF 



GETSI 
SI 

*, SYSINI* 



BUF 



ALF 



*, SI IN* 



Name of FILE in program library 



MSG Buffer for TTY 



File to go at $6000 



SIADDR EQU SIADDR($6000) 

SI 

GETFIL GTFILE GOT, (FILNAM), SIADDR, , ,0, 0^1 

/ 
Completion address 

after SYSINI is brought 

into core 



\ 



Address 
where 
file name 
is 




CP= 1 
RP= 
X bit = (not blank) 



Core 

address Disk address 
where left blank; 

file is program li- 

to go brary will be 

searched 



EXIT (wait for completion) 



EXIT (unnecessary) 



GOT 
SUN 



SQM NOGOOD 

FWRITE $FC, WROTE, BUF, 3, A, 0,1, 1,0 



LUN 

(std comment 

device) 



COMPL 
ADDR 



j h h u u h | X bit = (not blank) 

Indirect bit referring to $FC 
CP= 1 
MSG RP = 

BUF ASCII 
3 words 



EXIT 

Wait until Write is done 



WROTE 



SQM 
JMP* 
NOGOOD EXIT 



END 



NOGOOD 
(GETFIL+6) 



SI 



Jump to beginning address of 
SYSINI which is $6000 
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8.3.6.13 

This program may be reassembled for any system. Change the EQU for the desired 
high core address where the system initializer is to be placed. The system initializer 
should be stored in the program library under the file name SYSINI. It can then be called 
into core by typing on the TTY 

*SI 

SYSINI was made a file so it could be stored in high core. 



O 



o 
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8. 3. 7 LOADER Request - Request Code 7 

This request may be made only by background programs. 

The loader request enables the program to load programs during execution. A 
program is loaded beginning at the first word of unassigned, unprotected core. 
When loading, the loader resides in the upper part of unprotected core, wiping 
out COMMON if it was being used. 

The parameters for the loader request are in the A and Q registers. These 
parameters prescribe what type of load is to take place and from which logical 
unit. 





15 




3 







A 


Cu 


t 




15 











Q 


tna 



t type of loading operation; discussion follows 

fiu logical unit number of the input unit if a relocatable binary program is being 
loaded 

tna entry point, core address of the first of three sequential locations containing 
the entry point name 



Function 



£u 



tna 






Load relocatable binary programs 
from any unit 


input device 


ignored 


1 


Load from program library 
on library unit 


library unit 


ignored 


2 


Load program from library 


library unit 


location of 




unit and execute immediately 




program name 


3 


Produce memory map 


ignored 


ignored 


4 


Look up entry point name 


ignored 


location of 
entry point 
name 


5 


Same as t = 1 but no memory map 
printed 






6 


Search directory of core-resident 
entry points 


ignored 


ignored 


7 


Initialize data base 


ignored 


ignored 
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When the load is completed without an error, the A register contains the last 
transfer address given, as in normal loading. If an error terminated loading, A 
contains zero and the Q register contains the storage address of the input block 
processed by the loader at the time the error occurred. 



8. 3. 7. 1 Format of the LOADER Request 









RTJ- 








($F4) 




15 



14 






1 


1 


9 
1 


8 






A 


U 




u 



The macro call would be: 

LOADER 
An example of a coded request would be: 



RTJ- 

NUM 



($F4) 
$0E00 



O 



See the core request for a program example using the loader request. 

8. 3. 8 CORE Request - Request Code 11 

The core request can be made only by background programs. 

The core request can expand or contract available unprotected core. For exam- 
ple, if during execution the high locations of one's program are no longer needed, 
one could release these locations by a core request so that another program could 
be loaded into this area. 

The core request has two forms, depending on the contents of the A and Q regis- 
ters. If A and Q are zero, the core request asks for the current boundaries of 
unassigned unprotected core. When the request has been processed, the Q reg- 
ister contains the lower boundary-1 and the A register contains the upper 
boundary+1. (The contents of A and Q are actually obtained from core locations 
$ED and $EC.) With this information the program can set new boundaries to 
available unprotected core. 

When A and Q are non-zero and a core request is made, the new boundaries are 
set according to the contents of A and Q. A contains the new upper boundary and 
Q the lower. Both boundaries must be within unprotected core and A must be 
larger than Q. 

The core request is supposed to return the actual lower and upper bounds of un- 
protected core, but since it currently returns the lower-1 and upper+1 (from $ED 
and $EC) we program it to allow for that. 
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8. 3. 8. 1 Format of Core Request 









RTJ- 














($F4) 








15 



14 






rc 
1 


1 


9 
1 


8 


























The macro call would be: 




CORE 




The coded call would be: 




RTJ- 


($F4) 


NUM 


$1600 


8. 3. 8. 2 Example of Core Request 





The following example program, LOADERC, makes a core request to obtain 
bounds. It then drops the lower bound by 22 16 . Then it makes a loader request 
to load a relocatable binary program tape from logical unit 2. The program on 
the tape will begin to overlay the BSS block in LOADERC at address POOH. 
LOADERC receives the entry point address in A from the loader (from the end tna 
card of the loaded program) and stores it in the second word of the jump instruc- 
tion, where it can jump to the loaded program. 



0001 






NAM 


LOADERC 




0002 






EXT 


ENTRY 


Unpatched external 


0003 




0002 


EQU 


TAPEU(2) 




0004 


P0000 


0846 XX 


CLR 


A,Q 




0005 






CORE 




Get core limits 


0005 


P0001 


54F4 








0005 


P0002 


1600 








0006 


P0003 


0DDD 


INQ 


-$22 




0007 






CORE 




Set lower limit 


0007 


P0004 


54 F4 








0007 


P0005 


1600 








0008 


P0006 
P0007 


COOO 
0002 


LDA 


=XTAPEU 


Set up LUN 


0009 


P0008 


0FC4 


ALS 


4 




0010 






LOADER 


Call loader 


0010 


P0009 


54 F4 








0010 


P000A 


0E00 








0011 


P000B 


6802 


STA* 


XA+1 


Save entry point address 


0012 


POOOC 
POOOD 


1400 XA 
0000 P 


JMP+ 


** 


Jump to it 


0013 


P000E 


0B00 


NOP 






0014 






EXIT 






0014 


P000F 


54F4 








0014 


P0010 


0A00 








0015 






ENT 


XX 




0016 


pooh 


0022 




BSS PT($22) 




0017 






END 


XX 
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8. 3* 8. 2 



The system recovery package was used to dump some of the program area be- 
ginning at P000D inLOADERC. It shows that the new buffer of the loaded program 
exactly overlay ed the BSS in LOADERC; then the write request, beginning at 
P0009 in the new program, wrote out the confirming message. 

Use of the system to execute this job is covered in Chapter 9, but the example is 
included here so that it can be studied for later reference (since it applies to 
the core and loader requests). 



O 
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RE DUMP 

Buffer PT began here at 2F3F but is now overlayed 
by message buffer. CORE wiped out PT buffer and 
set new lower limit at 2F3F. 
New program F was 
loaded at 2F3F. 

ANOTHER EXAMPLE Write request at 

entry point of F 
F 2F3F ( A | 

T2F3B 2F48 0B00 54F4 0A00 414E 4F54 4845 5220 4558 414D 504C 4520 0008 54F4 0C01 2F51 

REDUMP<2F4B 0000 1004 AF47 2F3F 54F4 0A00 0179 54F4 0D01 0009 0000 1004 FFF3 7FEB 54F4 0A00 

/2F5B 1804 V. _ „ . , 

*-» \ Buffer address in F 



oo 

CO 

oo 



TTY PRINTOUT 



00 *p 

en j 

oo 



*L,8 

J 

*SR 

J 

*X ^, Unpatched external ENTRY which was not needed so 

ignored. 
E * ^ 

L, 02 FAILED 02 1 Load F from paper tape reader. There is no *T on 

ACTION J the end of the tape, hence the message and CU. 

CU 

ANOTHER EXAMPLE 
ANOTHER EXAMPLE 

RE 

*2F3B 

ERR 

RE 

*D2F3B, 2F5B -« RE Dump Request 



I 

j Output from Program F 



RE 



8.3.9 

(^_) 8. 3. 9 INDIR Request - No Request Code 

This request can be used by foreground or background programs under MSOS only. 
It is not a separate request but is an indirect version of any other request. 

Any request can be used again without repeating the request by using the INDIR 
request. 

8. 3. 9. 1 Format of the INDIR Request 



RTJ- ($F4) 



15 
1 



ap 



O 



Only in the INDIR request should bit 15 of the first word of the parameter list be 
set to 1. This tells the system that the word under the RTJ- ($F4) is not a 
parameter but is the address of the parameter list to be requested. 

The macro form is: 

INDIR (p) 

p is the address of the parameter list; it must be in parentheses. 

To code the call: 

RTJ- ($F4) 

ADC (REQ+1) 

(if the desired request parameters begin at REQ+1) 

8.3.9.2 Example of the INDIR Request 

An example of the INDIR request would be one in which the reques t parameters 
could be stored in a buffer and an indirect request could cause them to be executed. 

The following example stores the buffer address for MESSAGE in the s field of a 
request at REQBUF (the number of words in n) and then executes the request at 
REQBUF. 

Note that by using the INDIR request, control returns beneath it after the request 
is initiated. If a jump had been made to REQBUF-1 (if a RTJ- ($F4) were there), 
control would return under the parameter string at REQBUF. This may not be 
the desired action. 



o 
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8.3.9.2 



BUF 



ALF 



*, MESSAGE * 



LDA 

STA* 
ENA 
STA* 
INDIR 



=XBUF 

S 

4 

N 

(REQBUF) 



REQBUF 



N 
S 



NUM 
ADC 

NUM 
NUM 
NUM 
NUM 



$0C01 

COMPL 



$1004 







FWRITE 



ASCII, TTY 



More example s of the INDIR request appear in the routine CKASSM in the next 
section, 8. 4. 

8.4 PROBLEM 

The following program is a routine which can be used to check out the macro assembler. 
Study it c a r e f u 1 1 y to see what it does. 

After studying the program as it is written, figure out what would happen if the two SQP 
instructions at P0007 and P000D were SQN instead. 

Comprehension of the CKASSM routine should be considered a "final examination" on re- 
quests. Any points which are not thoroughly clear to the reader should be restudied 
carefully in the appropriate sections. A very good knowledge of these requests is re- 
quired before the student goes on to study Part II of the training manual. 
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0001 










NAM CKASSM 84758702 


0002 
0003 








* 


DECK ID 84fb8f02 JUNt 4» 1968 
VERIFICATION TEST FOR A007 MACRO ASSEMBLER 


0004 
0005 








4 


SPEC ID REFtR TO 84800300 

PROGRAMMING SYSTEMS* A/D SYSTEMS DIVISION* CDC 


0006 
0007 










ASSEMBLE USING WOO MACRO ASSEMBLER 
THIS PROGRAM IS A VERIFICATION FOR THE 


0008 
0009 








* 


MACRO AbStMbLtK 

THIS IS ONE OF A SERIES OF TESTS THAT USES 


0010 
0011 










lNUlRhCI SYSItM HtQUt5IS ON VARIOUS 
COMBINATIONS OF (F) READ/ (F) WRITE REQUESTS. 


0012 
0013 


P0000 


OBOO 




CKASSM 


ENT CKASSM 
NOP 


0014 
0014 


P0001 


54F4 






INDIR (Fl+1) 


0014 
0015 


P0602 


80C5 


P 




INDIR (Wl+1) 


0015 
0015 


P0003 
P0004 


54F4 
80BC 


P 






0016 
0016 


P0005 


54F4 




INI 


INDIR (Tl+1) 


0016 
0017 


P0006 
P0007 


80B8 
0161 


P 




/ 
SQP 1 


0018 
0019 


P0008 


18FC 






JMP« INI 
INDIR (Rl+1) 


0019 
0019 


P0009 
POOOA 


54F4 
80AF 


P 






U02U 
0020 


POOOB 


54F4 




1N2 


1NU1R (12+1) 


0020 
0021 


POOOC 
POOOD 


80AB 
0161 


P 




SQP 1 


0022 
0023 


POOOE 


1BFC 






JMP* IN2 

FWRITE $FC»,BUF»25,B, ,,I 


0023 
0023 


POO OF 
P0010 


b4r-<t 
OCOO 








0023 


POOH 
P0012 


0000 
0000 








0023 
0023 


P0013 
P0014 


08FC 
0019 








0024 


POOlb 


004A 


P 




EXIT 


0024 
0024 


P0016 
P0017 


54F4 
OAOO 








0025 


P0018 
P0019 


4E45 
5854 




MSG 


ALF 25»NEXT MESSAGE SHOULD INDICATE VERIFICATION 




P001A 
P001B 


2U4L) 
4553 










P001C 
P001D 


5341 
4745 










P001E 
P001F 


2053 
484F 










HUU2U 


554C 









P0021 
P0022 



4420 
494E 



P0023 


4449 


P0024 
P0025 


4341 
5445 


PUU2b 
P0027 


2Ubb 
4552 


P0028 
P0029 


4946 
4943 


P002A 


4154 



P002C 
P002D 


4E20 
2020 


P002E 
P002F 


2020 
2020 


PUOJO 


2020 



P002B 494F 
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0026 P0031 4D41 



MSG1 



ALF 25*MACRO ASSEMBLER ON 1700 OK 





P0032 
P0033 


4352 
4F20 












P0034 
P0035 


4153 
5345 












P0036 
P0037 


4D42 
4C45 












P0038 
P0039 


5220 
4F4E 












P003A 
P003B 


2031 
3730 












P003C 
P003D 


3020 
4F4B 












P003E 
P003F 


2020 
2020 












P0040 
P0041 


2020 
2020 












P0042 
P0043 


2020 
2020 












P0044 
P0045 


2020 
2020 












P0046 
P0047 


2020 
2020 












P0048 
P0049 


2020 
2020 










0027 
0028 


P004A 


0060 




T2 


BZS BUF(96) 
STATUS 5,R1+1 




! 0028 
0028 


PUOAA 
POOAB 


b4!-4 
0600 










0028 
0028 


POOAC 
POOAD 


0005 
OOAF 


P 








0029 
0029 


POOAE 


54F4 




Rl 


f-RLAU $C2»»BUF,2b*B***I 




0029 
0029 


PUOAh 
POOBO 


OtfUU 
0000 










0029 


PU0B1 
P00B2 


0000 
08C2 










0029 


P0UB3 
P0OB4 


0019 
004A 


p 








0030 


HUUbb 
P00B6 


UUUU 
0001 






NUM U»l 




U031 
0031 


P00B7 


54F4 




11 


STATUb b*Wl+l 




0031 
0031 


P0OB8 
P00B9 


0600 
0005 










UU31 
0032 


PUUBA 


OOBC 


H 


Wl 


FWRITE $C2»*MSG1»25»B,* 


♦ I 


0032 
0032 


POOBB 
POOBC 


54F4 
OCOO 










0032 


POOBD 
POOBE 


0000 
0000 










0032 
0032 


POOBF 
POOCO 


08C2 
0019 










0033 


P00C1 
P00C2 


0031 
0000 


p 




NUM 0,1 






P00C3 


onoi 











c 
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0034 Fl 


FWRITE $FC»»MSG»25»A»»*I 


0034 P00C4 54F4 
0034 P00C5 0C00 


0034 P00C6 0000 
P00C7 0000 


0034 P0OC8 18FC 
0034 P00C9 0019 


POOCA 0018 P 
35 


END CKASSM 



J 

*p 

J 

*ASSEM 

OPTIONS LX 

J 
*p 

J 
*L, 5 

J 

*X,N 

NEXT MESSAGE SHOULD INDICATE VERIFICATION 

MACRO ASSEMBLER ON 1700 OK 

J / 
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9.1 JOB PROCESSOR 



The job processor is that part of the operating system which monitors the background. 
It is a system program, and it allows jobs to run in the background when the system does 
not need the CPU or the background core area. Under the control of the job processor 
are the program library and such jobs as assembling, loading, compiling and executing. 

The job processor resides in the system library on the mass storage device until it is 
called into execution by a manual interrupt and an * followed by any control statement and 
a carriage return (CR). 

For example: The operator depresses the MI key and types *P. 

MI 

J 

The system will type the MI and J. (hi this chapter all messages typed by the operator 
will be circled. ) MI indicates that the manual interrupt has been accepted. 

The J will be printed when the job processor has come into core and is ready for a control 
statement. The job processor types its messages on the standard comments device which, 
in most cases, is the teletypewriter. 

Each control statement to the job processor must begin with an asterisk and must be 
terminated with a carriage return. The job processor will type a J when it has finished 
doing what it was instructed to do and is ready to accept another control statement. It 
will also light the BREAK light on the teletype, and the operator must depress the BREAK 
RELEASE key to turn off the light (and start the motor), then type his statement. If this 
light was not lighted, the system is not waiting for his input. 

If the operator realizes that he has typed the statement incorrectly before he types the 
carriage return, he can "erase" it by typing a rub out, line feed, carriage return and 
then proceed. 

JOX, hhhh indicates an error in a control statement to the job processor or a processing 
error in the background program. A summary of the error messages appears in Ap- 
pendix D. 

The following control statements are available for the operator to use to instruct the job 
processor in running a job. A brief description of their meaning is here and they are 
described in detail in the MSOS reference manual. 
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Figure 17. Control Statements Available Under the Job Processor 



Control Statement 
*p 

*K, Iu, Pu, Lu 

*L,u 
*X,m 

* gentry point> 

*Z 

*v 

*u 

*B 

*SR 

*R,u 



Meaning 

Brings in the loader, initializes for an inde- 
pendent loading operation. 

Alters standard logical units. Where I is input, 
P is punch and L is the list device. 

Loads a program from logical unit u. 

Executes the program that was loaded. If m is 
blank, the memory map will be printed. 

Loads a program from the program library and 
transfers control to it. 

If a job is in process, terminates the job. Fol- 
lowing a J, terminates job processor. 

Switches to standard input unit for subsequent 
control statements 

Returns control to comments unit for subsequent 
statements, (i.e., This statement could appear 
on the card reader. ) 

Brings in the breakpoint package. 

Brings in the system recovery package. 

Restores a logical unit u after it has failed. 

Terminates loading from input device. Should 
be last record of object deck being loaded. 

Continue execution. 



9. 1. 1 Assembling a Program 

Once an Assembly Language program has been written and placed in machine 
readable form (punched on a card, typed in USASI font for the OCR or punched on 
paper tape), it may be assembled by bringing in the assembler (*ASSEM(CR)) 
under the job processor's control. The *ASSEM(CR) statement assumes that the 
source deck will be read from the standard input device. For example, if the 
standard input device is the card reader, the programmer could place his cards 
in the hopper, depress the clear button and, at the teletypewriter, bring in the 
job processor and assembler in the manner described on the following page. 
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Input Cards Comments Device 

/ MON *" 

f'END GO C^Py 

J 



( *ASSEM ) 



ENT GO 
NAM EXAMPL J 

The *P brings in the job processor and the loader to load the assembler. As- 
sembly will begin immediately and will continue until a MON card or an illegal 
assembly card is encountered. 

In this case an OPT card was not used; therefore, a listing will be made, an 
object program will be prepared on the standard output device and the relocatable 
binary program will be stored on the first scratch sector of the mass storage 
device for immediate loading and execution. This binary image of the object 
program on mass storage is called "load-and-go" (LGO). 

If an OPT card is used, the operator will have a choice of three results: listing, 
punching an object program and "load-and-go". The computer will type OPTIONS. 



Input Comments Device 

r'MON J 

/END GO <*D 



( 



/ENT GO C*ASSEM) 

^NAM EXAM PL OPTIONS 

OPT 



The operator's response can be: L if he wants a listing; P if he requires an object 
program; and X if he wants the "load-and-go" eXecute option. In the s ituation 
where a programmer is debugging and wants a listing plus the "load-and-go" op- 
tion to allow an immediate load from the mass storage device, he would type the 
following: 

<*P> 
J 

( *assem ) 
options (xl) 

J 
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The X, L and P can be in any combination and in any order; e. g. , LX or just P. 

If more than one program is assembled in the same run and each has an OPT card, 
the assembler will ask for new options when it assembles each subsequent pro- 
gram. 



Input 



fMON 



£END 



£nam 



( OPT 



f / END~ 



( NAM 



/OPT 



END 



r 



/nam — 

OPT 



Assembling a Program, Illustration 1 



Comments 



J 



( *ASSEM ) 
OPTIONS ( XLJ 
OPTIONS QCLP; 
OPTIONS (XP^ 
J 



Col. 


Col. 


Col. 


Source 




1 


2 


3 


Program 




0001 








NAM EXAMPL 


0002 








ENT GO 


0003 


POOOO 
POOOl 
P0002 
P0003 
P0004 
P0005 
P0006 
P0007 
P0008 


4558 
414D 
504C 
4520 
5052 
494E 
5420 
4F55 
5420 


MESSAG 


ALF *, EXAMPLE PRINT OUT* 


0004 






GO 


FWRITE $FC, GOl, MESSAGE, 9, A, 0, 1, 1, 


0004 


P0009 


54F4 






0004 


P000A 


0C01 






0004 


POOOB 
POOOC 


0012 P 
0000 






0004 


P000D 


18FC 






0004 


POOOE 
POOOF 


0009 
0000 P 






0005 








EXIT 


0005 


P0010 


54F4 






0005 


P0011 


0A00 






0006 


P0012 


0806 


GOl 


SET Q,A 


0007 








END GO 


I 




00FF 


GO 


0009P MESSAG 0000P GOl 0012P 



Column one is the card number, e. g. , the symbol GO is on card four (4). Column 
two, when preceded by a P, is the address of each storage word relative to the 
beginning of the program. For example: the EXIT request takes up words lO^g 
and lli6« 
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The complete program occupies 13^ locations (0000-0012). Note that the ENT 
card doesn't occupy a location in the program nor does the END card. 

Column 3 shows the assembled code. For example, the first word of MESSAG 
assembles as 4558i6 which is the ASCII code for the letters EX. SET Q,A in 

machine language is 0806i6. If a letter follows the machine code, for example P, 
the contents of the word is to be modified at load time. In the previous example, 
the word will be modified by the program counter, e.g., If the program is loaded 
at location 2000^g then the contents, after loading, of word OOOB^g would be 
2000 16 + 0012 16 or 201216- 

Everything to the right of Column 3 is a printout of the source deck as it appeared 
on input. 

Assembling a Program, Illustration 2 



O 



Col. 


Col. 


Col. Source 






1 


2 


3 1 


Deck 






0001 






NAM 


PSEUDO EX 


0002 




0010 




EQU 


CAT(16) 


0003 




0000 D 
0032 D 




DAT 


BUF(50),EX(50) 


0004 




0000 C 




COM 


TABLE(50) 


0005 


POOOO 
POOOA 
POOOB 
POOOC 


OOOA 
0001 
0001 
0001 




BSS 


XX(10),X,Y, Z 


0006 




0032 D 




ORG 


EX 


0007 


D0032 
D0033 


C400 
0000 C 




LDA 


TABLE 


0008 


D0034 
D0035 


F0F0 
FFFF 




NUM 


$F0F0,$FFFF 


0009 


D0036 


0000 D 




ADC 


BUF 


0010 




0000 P 




ORG 


XX 


0011 


POOOO 
POOOl 
P0002 
P0003 
P0004 


5341 
4D20 
4953 
204F 
4B20 




ALF 


*,SAM IS OK* 


0012 




000D P 




ORG* 




0013 


P000D 


0B00 




NOP 




0014 


P000E 


0B00 




NOP 




0015 


P000F 


0000 




VFD 


X4/CAT 


0016 


P0010 


0B00 


QQ 


NOP 




0017 


POOH 


0B00 




NOP 




0018 








EXIT 




0018 


P0012 


54F4 








0018 


P0013 


0A00 








0019 








ENT 


QQ 


0020 








END 


QQ 
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In this example a D appears in column two - specifying the DATA area of storage. ( 
Thus, location 0032 of the DATA area will contain C400ig when loaded. 

The D and C following the machine instructions in column three indicate that these 
instructions will be modified by either the DATA counter or the COMMON counter. 
An X appearing in this position indicates an address external to the program. The 
COMMON and DATA counters are used by the loader when it is loading into these 
core areas. 

9. 1. 2 Loading and Executing a Program 

The general form for the -load statement is *L,u(CR). The u is for the logical 
unit of device from which the object deck is to be loaded. The program is loaded 
immediately but is not placed into execution until the *X(CR) statement is given. 
If a "load- and- go" option was chosen at assembly time, we could load and execute 
the program in the following manner (given that the scratch unit is logical unit 8): 

Input Comments Notes 

Device 



c 



c 



j^MON ® 

/ END G0 |assem) 

( OPTIONS (XLP) 



J 
(g) 



J 



^NAM EXAM PL (Jl^) 

OPT J 

(JXy Execute the Program 

EXAMPLE PRINT Output from the program 
J 

The following is printed on the standard list device as a result of the *L,8(CR) 
(program name and address where loaded): 

List Device 



EXAMPL 24E0 

and as a result of the *X 

List Device 
ENTRY POINT TABLE (MAP) 
GO 24E9 
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Note that it was necessary to call in the loader with a *P control statement before 
asking the loader to load with the *L statement. After the loader loaded the pro- 
gram, the printout EXAMPL 24E0 indicated that the absolute beginning core 
address where the program was loaded was $24E0. 

If one has an object deck to be loaded from another device (other than the scratch 
LGO device), the same sequence would take place but this time the other logical 
unit would be used. This would be, for example, an object tape made earlier 
being loaded. An *T(CR) must follow the last program to be loaded. 

There are two forms to the *X(CR) statement. Ifanonblank character is used 
after the X (i.e., X, N(CR)), the memory map (Entry Point Table) will not be 
printed. 

Input 




* T 



OBJECT DECK 



Comments 


List Device 


Device 




J 

(*a) 

J03,*A 




J 

J 

(*L,6) 
J EXAMPL 2 

(*x,n) 
example printout 


J 





Note that when an error on a control statement is made the job processor indi- 
cates the type of error, 03, that was made and prints out that error. In the above 
example, *A was an illegal control statement. 



o 



9. 1. 3 Other Job Processor Control Statements 

*K Control Statement 

There are times when the programmer would like to change the various standard 
units. He may prefer that his listing appear on the teletypewriter or be stored 
on another output device to be printed at a later time. The programmer may 
change any standard device except the comments device by the *K, Iu, Pu, Lu(CR). 
The I is for the input device with the u standing for the logical unit it is to be 
changed to. P is for the punch (or binary output) device and the L stands for the 
list (or print) device. For example, if the programmer wanted to store his re- 
locatable binary program on magnetic tape (logical unit 5 at his installation), his 
listing to appear on the comments device (logical unit 4), and his source program 
is on another magnetic tape drive (logical unit 6), he could type the following: 
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Comments 
Device 

J 

( %,P5,L4,I6) 
J 

*ASSEM 
OPTIONS (XLP) 
J 

The parameters P, L, I can be in any order and in any combination. The change 
will be in effect until another *K statement is given or until the system is auto- 
loaded again. It simply causes the contents of location $F9-$FD to be changed 
in core. 

It is usually a good idea for the programmer to r ef e r to standard devices in his 
program rather than directly to specific logical unit numbers. Then he can re- 
assign the units with the *K control statement if he desires. Particularly, for 
example, if he was outputting answers on the printer, he could output on the 
standard print device. Then if the printer was down, the output could be changed 
to go on the teletype without changing the program. 

A standard device is also used by the system when a particular function is to take 
place but the logical unit number of the particular device to be used may be dif- 
ferent for each installation. For example, a message is to be given to the operator 
but whether the teletype is logical unit 4 or 11, or whether the message is to be 
printed on a line printer or upon an auxiliary teletypewriter depends upon the 
purpose and configuration. The actual device to be used can be defined by the 
logical unit placed in the LOCORE word associated with the standard device. The 
logical units are assigned at installation time but may always be changed by a *K 
control statement. 

*V and *U 



The *V is used to direct the system to expect further control statements from the 
standard input device. The *U (on the input device) tells the system to switch back 
to the comments device for control statements. 

Input Comments 

Device 

J 

(*v) 

J 
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V ) These allow the programmer to put his control statements in the card deck rather 

than type them on the teletype. 

*<fentry Point Name) 

When a program has been placed on the program library either during system 
initialization or through LIBEDT it may be loaded into the system and brought into 
immediate execution by an * <£ntry point name) (CR) . The assembler and 
FORTRAN compiler work in this manner as do user written programs. 

Comments 
Device 



J 
<*p) 

J 



(*PGM ) Call in PGM 

J 

The following is an example of compiling, loading and executing a program under 
FORTRAN. The TTY printout is shown. 



O 



o 
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1700 MSOS 2. COMPILE AND EXECUTE 
Operator must first: STEP - center protect switch - master clear - autoload - run 



pp •* 

© - 

MI 



(JP 
J, 

(*ftn)** — ^ — N 

OPTIONS (^APX) 
_ I 



Set Protect Switch 
Manual Interrupt 

Assign Input to Card Reader 

Call in Loader 



Load FORTRAN 



I 



Source 
list 



PROGRAM NAME 

2 2 
CONTINUE 

3 3 
END 

0000 0000 
0000 1801 

3 0001 5400 

0002 7FFF 

3 0000 0000 

PROGRAM LENGTH $0003 

EXTERNALS 
Q8STP 



L list source 
A list assembly 
P punch object tape 
X object on disk 



NAME 
.00001 



NAM 


NAME 


JMP* 


.00001 


RTJ+ 


Q8STP 



END 



J 
J 



L,2W 



NAME 2066 
L,02 FAILED 02 
ACTION 

<CU) - 

J 

(*X) 



Call in Loader 

• Load object from PTR 
■ Loaded at $2066 

• Reader out of tape 

Continue 



Circled items are 
typed by operator 



Assembly list 



Execute 



*X, , will eliminate MAP 



PSSTOP 2069 
Q8PAND 20A5 
I ENTRY POINT TABLE- 
NAME 2066 Q8STP 



> MAP 



2080 Q8PSE 2069 Q8PSEN 206E 



Q8STPN 2087 Q8COMI 208A Q8PAND 20A5 



MAP 



STOP 
J 



Finished. Run next job beginning with *P. 



REL BIN OBJ PT 



aXQ 



U O 



a 




b 



CML> 







-**» 

?=•' W u 



<> <.o^, 



i .0 t> : 'U 



K> 



ooB 



L 



j/ 1 
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The next example is one in which the control statements were on the input unit. In 
this case the card reader was used so the control statements were on cards with 
the source deck. TTY (comments device) printout and printer (list device) print- 
out are shown. 



r~\ 



TTY PRINTOUT CONTROL STATEMENTS ON INPUT UNIT 



-«* Typed by operator. "Options" would also be typed by operator. 

-* Typed by operator. 



MI 

*V 

E * 

THIS PROGRAM WORKS ON THE 1700 COMPUTER SYSTEM UNDER MSOS 2.0 
j > 

Program Printout 

(Formatted ASCII Write) 

Deck Setup: 

Operator must type *K (if needed to assign units), *V to send control to input unit. 



Deck would contain: 



O 



*P 

*ASSEM 
NAM 



E 

MON 
*p 

*L, 8 
*X,, 

*U 



El 

NAM 

ND 



(or *FTN) 

— *#- 



If OPT used, operator must type options 
LAPX, etc. 



etc. 



Load from LGO unit (i. e. , 8) 

If missing subroutines, operator must type *CR 
To return control to TTY 
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Printer Output 
Control Statements on Input Device 



p -* 


*p 












ASSEM- 


* — *ASSEM 












Deck 












0001 








NAM 


CARD TO PRINT 


0002 








ENT 


START, PRINT 


0003 








(EXT 


IOERR ) 




0004 




OOEA 




EQU 


ADISP($EA) 




0005 


P0000 


0000 


START 










0006 


P0001 


54F4 




RTJ- 


($F4) 




0007 


P0002 


0201 




NUM 


$0201 


READ, CP=1 


0008 


P0003 


0009 P 




ADC 


COMPRD 




0009 


P0004 
P0005 


0000 
100C 




NUM 


0, $100C 


THREAD, LUN CR=12, ASCII 


0010 


P0006 


0028 




NUM 


40 


ONE CARD TO READ 


0011 


POO 07 


001F P 




ADC 


BUF 


FWA BUFFER AREA 


0012 


P0008 


14EA 




JMP- 


(ADISP) 




0013 


P0009 


0162 


COMPRD 


SQP 


SCHPRT 




0014 


POOOA 
POOOB 


5400 X 
7FFFX 




RTJ 


IOERR 




0015 


P000C 


54F4 


SCHPRT 


RTJ 


r - ($F4) 




0016 


P000D 


1200 




NUM 


$1200 




0017 


POOOE 


0011 P 




ADC 


PRINT 




0018 


P000F 


54F4 




RTJ- 


($F4) 




0019 


P0010 


OAOO 




NUM 


$A00 


EXIT REQUEST 


0020 


POOH 


54F4 


PRINT 


RTJ- 


($F4) 




0021 


P0012 


0C01 




NUM 


$0C01 


PRINT, CP=1 


0022 


P0013 


001A P 




ADC 


COMPPR 


COMPLETION ADDRESS 


0023 


P0014 
P0015 
P0016 


0000 
1009 
0023 




NUM 


0, $1009,35 




0024 


P0017 


001F P 




ADC 


BUF 


FWA BUFFER 


0025 


P0018 


54F4 




RTJ- 


($F4) 




0026 


P0019 


OAOO 




NUM 


$A00 




0027 


P001A 


0162 


COMPPR 


SQP 


FINI 




0028 


P001B 
P001C 


5400 X 
OOOBX 




RTJ 


IOERR 




0029 


P001D 


54F4 


FINI 


RTJ- 


($F4) 




0030 


P001E 


OAOO 




NUM 


$0A00 


EXIT WHEN THRU 


0031 


P001F 


0028 


BUF 


BSS 


BUF(40) 




0032 








END 


START 




I 




OOFF ! 


START 


0000P 


PRINT 0011 P 


ADISP OOEA COMPRD 0009P 


SCHPRT 


OOOCP 


COMPPR 


001AP 


FINI 001DP 


BUF 001FP IOERR 001CX 


P 
L,8 






*L 


















CARD 22 


in ^ 


-Loaded at $2210 






J.U ^ 




x,, 


" 




Execute 








E10 














IOERR «*— 




Missing subroutine 







u 
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9.2 DEBUGGING 



After a program has been written, the programmer will want to run it to determine if 
the coding meets the specifications that he meant them to satisfy. There are basically 
two types of errors that may have been made: those of format and those of logic. The 
assembler and loader detect most of the format errors and notify the programmer via 
diagnostics. 

Two software packages are provided to help the programmer detect errors of logic: the 
breakpoint package and the system recovery package. 

9. 2. 1 Assembler Errors 



O 



If an error is made in the general format of the program the assembler may detect 
it in either of the first two passes or in the third. If an error is detected during 
the first two passes, the diagnostic will appear before the NAM card on the listing; 
otherwise, the diagnostic will be within the body of the program. If at assembly 
time the L option was chosen, the diagnostics will appear on the list device; other- 
wise, the diagnostics will appear on the comments device. 

When the error is detected during the first or second pass of the assembler, the 
diagnostic will take the following form: 

Column Contents 



1 * 

2-5 4-digit card number 

g_7 ** 

8-9 2-character error code 

10-19 ********** 

hi the following example a symbol to be used in an IF A pseudo- instruction must 
be defined before it is used. Therefore, the assembler prints the diagnostic UD, 
meaning undefined. The 0004 indicates the error occurred in card #4. 
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LIST DEVICE 



*0004**UD**** ****** 
*0004**UD********** 



0001 NAM 

0002 P0000 5448 ALF 
P0001 4953 

P0002 2057 
P0003 494C 
P0004 4C20 
P0005 414C 
P0006 5741 
P0007 5953 
P0008 2041 
P0009 5353 
P000A 4542 
P000B 4C45 

0003 P000C 0B00 NOP 

0004 XX IFA 

0005 ZZ ALF 



VARIABLE ASSEMBLY 

*, THIS WILL ALWAYS ASSEBLE* 



DOG, GT, CAT 

*, SOMETIMES ASSEMBLES DEPENDING UPON CAT* 



When an error is discovered in the third pass of the assembler, the assembler 
will print the message immediately before the line with the error in the following 
form: 



%>); ;)<:*** C") p sK *****%* * * 
******|JJ)* ********* 

0006 P0006 0000 



SHIFT TWO 



The PP in the first example says the error in that card was identified in the pre- 
vious pass. 

The next example shows the RL error messages for attempted illegal relocation 
outside the program area (relative). It also shows the EX message for the illegal 
expression in the address field of the VFD. 
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LIST DEVICE 






0001 






NAM 


PSEUDO EX 


0002 




0010 


EQU 


CAT(16) 


0003 




0000 D 
0032 D 


DAT 


BUF(50),EX(50) 


0004 




0000 C 


COM 


TABLE (50) 


0005 


POOOO 
POOOA 
POOOB 
POOOC 


OOOA 
0001 
0001 
0001 


BSS 


XX(10),X,Y, Z 


0006 




0032 D 


ORG 


EX 


0007 


D0032 
D0033 


C400 
0000 C 


LDA 


TABLE 


0008 


D0034 
D0035 


FOFO 
FFFF 


NUM 


$F0F0,$FFFF 


0009 


D0036 


0000 D 


ADC 


BUF 


0010 




0000 P 


ORG 


XX 


0011 


POOOO 
POOOl 
P0002 
P0003 
P0004 


5341 
4D20 
4953 
204F 
4B20 


ALF 


*, SAM IS OK* 


0012 




0000 P 


ORG* 




0013 


POOOD 


OBOO 


NOP 




0014 


POOOE 


OBOO 


NOP 





0015 P000F 0000 ADDRESS ADC* 

P0010 0032 

POOH FFF8 

P0012 FFF8 

P0013 FFF8 

P0014 FFFA 

0016 P0015 5800 BYTE 



VFD 



9. 2. 2 Device Failure 



BUF, EX, X, Y, Z, ADDRESS 



A8/X, B3/7 , B2/1, B8/$FF 



If while working with the 1700 System there is a device failure, the operating 
system will print the following: 

L,nn Failed ee 
ACTION 

The nn specifies the logical unit that failed and the ee an error code indicating why 
it failed. 
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Error Code Meaning 



00 Input/ output hangup (diagnostic tinier) 

01 Reject (internal or external) 

02 Alarm 

03 Parity error 

04 Checksum error 

05 Internal reject 

06 External reject 

For special errors for each device see the manual for its driver. 

The operator may respond in one of the following ways: 

RP Repeat the request. This assumes the 

operator has corrected the condition and 
wants to complete the operation. The 
operator may have forgotten to ready the 
device. Upon receiving a device failure 
message, he depresses the ready button, 
types RP and goes on as normal. 

CU Indicates the error has not been cor- 

rected but the operator would like to con- 
tinue operating. The program is notified 
of the error. 

DU The device is marked down for this re- 

quest and all future ones. This allows 
the operator to get back to the job pro- 
cessor and take the necessary steps to 
use another device for his program. 

CD The same as CU but, also, suspends job 

processing. 

DD The same as DU but, also, suspends job 

processing. 

In the example on the following page the load was from the paper tape reader. The 
paper tape was read past its end, as there was no *T(CR) on the end of the tape. 
The CU signalled the loader to continue as all the tapes had been read. 
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J 

*L,2 

L, 02 FAILED 02 

ACTION 

CU 

J 

If it had been desired to load another tape, the operator would have put it in the 
reader and typed RP instead. 



J 

( *assem) 

L, 02 FAILED 02 
ACTION 

<Su) 

J 

( *K, L11,I13 ) 
J 

J 



(Jassem) 
options (xl) 

J 

In this case the operator did not want to assemble from the standard device but 
forgot to change the logical unit before the *ASSEM statement. By marking the 
device down he got back to the job processor to change devices and continue. 

9. 2. 3 Loading Errors 



At the time of loading the loader may detect those types of errors that can only be 
detected at load time, such as undefined externals, DATA or COMMON declared 
larger by a second or third program than by the initiating program. The diag- 
nostics appear on the list device preceded by an E. 

9.2.4 Logic Errors (Detected During Execution) 



There are several standard software packages to help a programmer detect errors 
of logic. The Breakpoint Package and System Recovery Package aid in debugging 
programs in the background. UTOPIA and the On-line Debug Package are for de- 
bugging in the foreground in the real-time environment, hi this chapter the 
breakpoint package and system recovery package will be discussed. 
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The breakpoint package allows the programmer to do such things as run his pro- 
gram under different sets of trial data, divide his program into segments and 
execute only portions of his program at a time or check intermediate results as 
he goes along. The recovery package only functions after the program has aborted 
or finished normally. The programmer then can dump core or mass storage to 
determine the final state of his program and data. 

There are several reasons for using a debug package as compared to console de- 
bugging. One of the most important on the 1700 is that one can debug while the 
machine is being shared with other programs. It is also easier as several con- 
versions are made for the programmer and the programmer has a hard copy of 
his statements and results. 

9. 2. 4. 1 The Breakpoint Package 

The breakpoint package must be brought in by an *B sometime after an *P and 
before the program is put into execution. However, the breakpoint control state- 
ments are not used until after the *X statement. All numerics in the breakpoint 
package are in hexadecimal and all addresses are absolute core addresses not 
program addresses. A BP message from the computer indicates that the break- 
point package is in operation and expects a control statement. 

The *B control statement actually causes a flag to be set in the job processor so 
that after the *X control statement is typed the breakpoint package is brought into 
core and control is transferred to it. Therefore, the core area the breakpoint 
package runs in is physically the core area immediately above the area occupied 
by the background program. 
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Figure 18. Control Statements 
Control Statement 



o 



*Ahhhh(CR) 
*C(CR) 



*Daaaa , aaaa (CR) 



*Eaaaa, hhhh, .... (CR) 

*Ihhhh(CR) 

*Jaaaa(CR) 

*Msl, wl, s2, w2, n(CR) 

*P(CR) 
*Qhhhh(CR) 

*Raaaa(CR) 

*Saaaa, aaaa, .... (CR) 

*Taaaa, aaaa (CR) 

*T(CR) 

*Z(CR) 

For example: 



Available to Breakpoint Package 

Brief Description 

Enter register A with the hexadecimal 
number indicated by the hhhh. 

Continue execution after breakpoint 
reached 

Dump locations from hexadecimal ad- 
dress aaaa-^ through aaaa 2 . 

Enter locations in core from hexadeci- 
mal address aaaa with data hhhh, hhhh,.... 

Enter Index I with the hexadecimal num- 
ber hhhh. 

Jump, that is transfer control, to the 
address given by the aaaa. 

Dump data from the mass storage device 
beginning with the sector and word, si, 
wl through the sector and word indicated 
bys2,w2. Logical unit n. 

Print the contents of A, Q, I, P and M. 

Enter the Q register with the hexadecimal 
number given by hhhh. 

Transfer control to and set a breakpoint 
at location aaaa. 

Set breakpoints at locations indicated by 
the aaaa's. Maximum of 15 set at one 
time. 

Terminate breakpoints at the locations 
specified by the aaaa's. 

Terminate all breakpoints that have been 
set. 

Terminates the breakpoint package. 



Comments Device 

® 
J 



(*assem) 
options (xl) 

J 

( *K,IA) 
J 



J 



PSEUDO 2544 
PSEUDO 255D 



E8 
QQ 



CLASSP 255D 



Notes 



Note error and overlay 



o 



j 
© 

1 ENTRY POINT TABLE- 

***COM 7FCD 

***DAT 24E0 

QQ 2559 START 2587 

BP 
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At this point the programmer can enter any one of the available breakpoint state- 
ments. 

The programmer may want to break his programs into portions and execute them 
separately. An Saaaa,aaaa, . . . .CRsets a stop or breakpoint at the addresses 
, aaaa, so that during execution when the program reaches this point the program 
will halt and control will return to the keyboard. The breakpoint program will at 
that time print the message BP,aaaa indicating that the breakpoint at the address 
aaaa has been reached and the breakpoint program expects another control state- 
ment. 

For example, in the program EXAMPL listed as illustration 1 under Section 9. 1. 1 
perhaps the programmer would like to execute his program thru the EXIT on card 
5, program location 12. He would probably take the TTY listing which has the 
address of the first location of his program (24E0). He would then add the pro- 
gram relocatable address of the instruction where he wants the breakpoint to the 
first location. He would set the breakpoint one instruction after the last instruc- 
tion that he wants executed. For example: 

Comments Device Notes 



J 
J 



EXAMPL 24E0 24E0 machine address of program 

J + 12 instruction in program 

(*5) 24F2 actual address 

J 

@> 
J 

© 

1 ENTRY POINT TABLE- 
GO 24E9 
BP 
( fS24F2) 

BP 

( *D24E0,2"4F2 ) 

24E0 4558 414D 504C 4520 5052 494E 5420 4F55 5420 54F4 
24EA 0C01 24F2 0000 18FC 0009 24E0 54F4 0A00 54F3 
BP 

( *J24E9 ) 

EXAMPLE PRINT OUT 
BP, 24F2 
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The *S24F2 sets a breakpoint at 24F2. The D24E0, 24F2 dump s that core area. 
The J24E9 jumps to location 24E9 (P0009) and executes the write. The program 
stops at 24F2 before executing the SET A,Q instruction. 

One can set a maximum of 15 breakpoints with one *Saaaa(CR). However, many 
more than that can actually be set at any one time. A breakpoint at a location is 
actually a RTJ to the breakpoint package inserted in place of the actual code. The 
actual code is kept by the breakpoint package to be executed and to be returned 
when the breakpoint is removed. Therefore, several considerations should be 
made when setting a breakpoint. A breakpoint should not be set at a non- executable 
instruction such as a data word because the program would never get to that word 
to execute the RTJ, and therefore would not stop at that breakpoint. Also, the 
breakpoint should not be set at the second word of a two-word instruction because 
when that instruction is put into execution the RTJ would then be interpreted as an 
address rather than executed as a jump to the breakpoint package. The breakpoint 
should not be placed at a location that will be modified or changed during execution. 
For example, a breakpoint should not be set at an instruction whose address is to 
be modified or the first word of a subroutine whose entry is via a RTJ for then 
again the RTJ to the breakpoint package would be modified or destroyed and the 
result would be unpredictable. 

A breakpoint should never be set on an RTJ instruction because the actual instruc- 
tion is executed in the breakpoint program itself. Hence, the actual program's 
RTJ would take the wrong address with it. 

If a breakpoint is to be cleared, the *Taaaa, aaaa(CR) statement is used. If all the 
breakpoints that have been set are to be cleared, the*T(CR) statement is used but 
none of the addresses are specified. 

The contents of the registers are printed out with the *P(CR) statement. 

BP 



® 



REG. A=18FD Q=18CD 1=0814 M=9000 P=54FF 
BP 

One can enter each of the registers except M by indicating the register and typing 
the hexadecimal number that is to be entered. 

BP 

( JAFOFO ) 
IBP 

( jtffff ) 

BP 

( *Q1234) 

BP 
(g) 

REG. A=F0F0 Q=1234 I=FFFF M=9000 P=54FF 
BP 
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The contents of core can be dumped by the *Daaaa,aaaa statement. The first aaaa f 
specifies the first location the programmer wants to print and the second aaaa 
specifies the last. 

BP 

*S24F2 

BP 

( *D24E0,24F2) 

24E0 4558 414D 504C 4520 5052 494E 5420 4F55 5420 54F4 
24EA 0C01 24F2 0000 18FC 0009 24E0 54F4 0A00 54F3 

BP 

The output from the *P(CR) statement is on the standard list device. In this ex- 
ample the list device" has been made the same as the comments device with an *K 
statement. This example is a dump of the program listed as Illustration 1. Note 
that the last location printed out (54F3) has been set as a breakpoint. 

If only one location is wanted, specify the single address. 

BP 
(*D24E0) 

24E0 4558 
BP 

If one wants to enter a location in core an *Eaaaa, hhhh, hhhh, .... (CR) is used. 
The aaaa specifies the first address to be entered and the following hexadecimal 
numbers to be placed in each sequential location. 

BP 

( *E2557, FFFF, 0000, FFFF ) 

BP 

( JD2557,2559 ) 

2557 FFFF 0000 FFFF 

BP 
( *EAAXX ) 

B01, *EAAXX Note the error message 

BP 

*E2557, AAAA, BBBB, CCCC 

BP 

( *D2557,2559 ) 

2557 AAAA BBBB CCCC 

BP 
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If a location is to be skipped, i. e. , not entered with data, skip that location by 
typing two commas in a row. This indicates that the location is to be left unaf- 
fected. If a location is to be filled with zeros, the zeros must be specified. 

When a programmer would like to begin execution of a sequence of programming 
out of the normal sequence, he may use" the jump statement, *Jaaaa(CR) to the 
instruction to be executed. Execution begins immediately after the *Jaaaa state- 
ment. The aaaa is the address of the first instruction to be executed. 

J 

( *K, L4 ) 
J 



(*p) 



J 



EXAMPL 24E0 
J 

(*B) 
J 

(^SR) 
J 

1 ENTRY POINT TABLE- 
GO 24E9 
BP 
( *S24F2 ) 

BP 

( *D24E0,24F2) 

24E0 4558 414D 504C 4520 5052 494E 5420 4F55 5420 54F4 
24EA 0C01 24F2 0000 18FC 0009 24E0 54F4 0A00 54F3 
BP 

( *J24E9) 

EXAMPLE PRINT OUT 
BP,24F2 

The *J24E9 caused the jump to P0009 to execute the write. 

The return jump *Raaaa is used when an iterative loop is being checked out and 
the programmer would like a stop at each execution of the loop. 

The contents of words on the mass storage device may be dumped using the 
*Msl, wl, s2, w2, nCR where: 

si is the beginning sector number 

wl is the beginning word to be dumped of that sector 

s2 is the last sector to be dumped 

w2 is the last word of that sector to be dumped 

f~^] n is the logical unit of the disk 
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There are several combinations that one can use. If, while working in the back- 
ground, the scratch unit is wanted, the n may be omitted and the scratch unit is 
assumed. If complete sectors are wanted, the word specification can be omitted 
and the complete sector will print, If one wanted to examine a file that has been 
stored on sector 24 of the disk, he could do the following: 

*M24(CR) 

The programmer may begin in the middle of a sector and dump the rest of the 
sector by specifying the first sector and first word but omitting the second sector 
and word. 

If the first complete sector of scratch is wanted, type 

*M(CR) 

Examples of the *M statement are under the system recovery section as the system 
recovery's *M works exactly the same as the breakpoint's. 

If at any time the program is to be terminated, a MI and an *Z(CR) will do so. An 
example of *Z being used to terminate a job is in the first program in the system 
recovery section. 

If an error is made while using the breakpoint package, the breakpoint package 
will print a message beginning with a B. The possible error statements are as 
follows : 

BO 1, statement Statement or parameters are unintelli- 

gible for the breakpoint program. 

B02,hhhh hhhhig cannot be processed by break- 

point program because it is protected. 

B03,hhhh Breakpoint limit exceeded, hhhh^g is 

the last breakpoint processed. 

B04 Previous *E statement requested entries 

in protected core. Entries are not pro- 
c e s s e d; breakpoint program waits for 
new statement. 

9. 2.4. 2 System Recovery Package 



The system recovery package is called in with an *SR(CR) before the program is 
executed just as the breakpoint was. However, the system recovery package does 
not function and does not accept control statements until after the program has 
finished normally or aborts. A RE message indicates that Recovery is in and is 
ready to receive a statement. 



v.... 
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Figure 19. Control Statements Available to the System Recovery Package 



O 



Control Statements 
*Daaaa-^, aaaa2(CR) 

*Msl, wl, s2, w2, n(CR) 

*T(CR) 

*n(CR) 



Brief Description 

Dump locations of core beginning with hexadeci- 
mal address aaaai and ending with hexadecimal 
address aaaa 2 . 

Dump mass storage unit n from sector and word 
sl,wl to sector and word s2,w2. 

Terminate the system recovery package and re- 
turn to the job processor. 

Change the list device for dumping contents of 
core or mass storage. 



The statements for dumping core and mass storage are the same as for the break- 
point. The output is on the standard list device. 

An *T(CR) terminates the system recovery package. 

J 
(*p) 

J 

(*l7§) 

EXAMPL 24E0 
J 

(*B) 
J 



Note that breakpoint and recovery flags may be 
set 




J 

(*x) 

1 ENTRY POINT TABLE- 



GO 



24E9 



BP 



(*J24E9) 

EXAMPLE PRINT OUT 
BP, 24F2 

Vs 1 y The operator presses the manual interrupt 

^ — ^ ^ button on the typewriter here if he desires to 

V— y terminate job execution and enter the Recovery 

s ^ package 

( *D24E0,24F2 ) 

24E0 4558 414D 5048 4520 5052 494E 5420 4F55 5420 54F4 

24EA 0C01 24F2 0000 18FB 0009 24E0 54F4 0A00 54F3 

RE 



o 



The*D above dumps core from 24E0 through 24F2, after the program has executed. 
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BP 

( *J24E9 ) 

EXAMPLE PRINT OUT 
RE 

<S) 

RE 
( *M,15,,12^ ) 

ERR 

RE 



Note: ERROR Occurred because word 1 is larger than word 2. 



(*m7iF) 

SECTOR NUMBER 0000 

0015 5800 0D03 0302 1803 

001F 0400 1401 0000 0844 

0029 0F0A 0121 18DF 18F5 

0033 0B00 0000 0000 0000 



0B0O 


18F0 


E80D 


0B00 


C8E0 


1CF2 


0000 


0000 



5806 0D04 03FB 5803 

02FE A30B B80B 0104 

0000 0181 0039 0019 

0000 0000 0000 0000 



RE 



(*D2137^ 
























2137 




C80D 




















RE 


58) 






















(*D24E0, 25 




24E0 




0001 


0163 


0A00 


0001 


0002 


0003 


0004 


0005 


0006 


0007 


24EA 




0008 


0009 


000A 


000B 


OOOC 


000D 


000E 


000F 


0010 


0000 


24F4 




0000 


FFFE 


FFFA 


FFFC 


FFFB 


FFFA 


FFF9 


FFFF 


5443 


4520 


24FE 




534D 


414C 


4045 


5354 


204E 


4F2E 


2049 


5320 


4154 


204C 


2508 




4F43 


2E20 


0000 


24E3 


68D5 


0842 


481D 


0C17 


5825 


54F4 


2512 




0D01 


0008 


0000 


18FC 


001E 


7FEA 


54F4 


0A00 


54F4 


0D01 


251C 




0008 


0000 


08FC 


0001 


255E 


54F4 


0A00 


54F4 


0D01 


0008 


2526 




0000 


18FE 


000A 


0031 


0000 


0B00 


0000 


2560 


68B3 


0C09 


2530 




5805 


0000 


18FD 


68F7 


18DC 


0B00 


CCAB 


68A8 


68A8 


D8A8 


253A 




0DFE 


0161 


1CF8 


90A4 


01A7 


0138 


CCA1 


689E 


C800 


FF9E 


2544 




681A 


18F3 


0131 


18F8 


CC99 


9897 


01A6 


012A 


CC95 


6893 


254E 




C893 


6810 


18E8 


0131 


18E6 


18F8 


5448 


4520 


534D 


414C 


2558 




4045 




















RE 

























(*M, 124, 25, 
SECTO 


,1& 




»r Number 


0000 


















0124 




0814 




















SECTOR NUMBER 


0001 


















0001 




5803 


404F 


4144 


FFFF 


6804 


4804 


1800 


0003 


FFFF 


FFFF 


000B 




5800 


00D0 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0015 




0000 


0000 


0000 


0000 


5000 


0000 


0000 


0000 


0000 


0000 


001F 




2020 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


SECTOR NUMBER 


0002 


















0001 




0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


2020 


2020 


000B 




2020 


0000 


0000 


0000 


0000 


1400 


FFFF 


FFFF 


FFFF 


FFFF 



** 



RE 

(*t) 

J 



Note: ** implies that the 0000 or FFFF continues for the rest of the sector. 



r 
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[ j In the previous example the *4 reassigns output to lun4, the TTY. The *M, 15 im- 

plies sector of scratch from word 15 on. *D2137 dumps location 2137. 
*D24E0, 2558 dumps those locations, inclusive. *M, 124, 25, 124 dumps several 
consecutive sectors. 



O 
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10.1 

CONFIGURING A SYSTEM 

The content of this chapter will be devoted to the 1700 and its peripherals as a total system. 
It is designed to assist the presales analyst in configuring a system by considering the inter- 
relationship of the various pieces of hardware. Each has its own characteristics which must 
relate to and interface with the total hardware configuration. 

Figure 20 is a diagram of most of the standard hardware and it should be consulted as a 
reference from the text in this chapter. Figure 21 also contains the hardware and it includes 
the new hardware. 

10.1 CENTRAL PROCESSOR 

The basic 1704 computer consists of the central processor, arithmetic unit, 4K memory 
and A/Q channel access to the low-speed I/O package via the slow- channel synchronizer, 
equipment number 1. 

Memory modules maybe added in 4K (1708) increments to a maximum of 32K. The 1709 
(8K module) is available only on a used basis. A new hardware addition has recently 
been made to the product line to allow an increase of memory size to 65K. 

Two interrupt lines are included: line for internal interrupts and line 1 for the slow- 
channel synchronizer. 

10. 1. 1 Low Speed I/O Package 
(~*\ The low- speed package consists of: 

• teletypewriter 

1711 - keyboard entry and printer only, 100 characters per second 

1712*- keyboard & printer, 100 cps, with offline mechanical paper tape 
reader and punch 

1713 - keyboard, printer, on-line mechanical paper tape reader and punch, 
100 cps 

• paper tape reader 

1721 - 400 cps reader, electronic 

1722 - same reader, with added take-up and supply reels 

• paper tape punch 

1723 - 120 cps punch 

1724 - same punch, with added take-up and supply reels 

• card reader 

1729*- 100 card-per- minute reader, replaced by 1729-2 which connects to 1705 



; Only available used on an as -available basis. 
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These are the standard peripherals connected to line 1; other peripherals must 
normally be connected through a 1705. Some existing configurations do have 
special peripherals other than those above on line 1, but this is on a QSE basis 
and each case must be considered individually. 

10.2 1705 INTERRUPT DATA CHANNEL 

Any system which will require more than the two basic interrupts or the peripherals in 
the low-speed I/O package will need a 1705. The addition of the 1705 will add the fol- 
lowing capabilities to the system: 

a) addition of 14 more interrupt lines for external equipment 

b) addition of up to eight controllers to the A/Q channel 

c) addition of direct memory access for up to eight buffered controllers 

See note A, Figure 20, for additional explanation of line connections. 

Input/Output for the additional eight controllers would be unbuffered if they are connected 
to the A/Q channel only. I/O will be buffered if they are connected to the A/Q channel 
and the DSA bus and are either capable of doing direct memory access on their own or 
are connected through a 1706 or 1716. 

10. 3 BUFFERED CONTROLLERS 

Three controllers are capable of performing data transfers directly between computer 
memory and the attached peripheral device: 

1738 disk controller - controls one or two 853 (1. 5-million-word) or 854 (3. 0-million- 
word) disks, 

1751 drum controller - controls drum; size from 65K to 524K words, 

1748 master communications terminal controller - controls up to 64 remote com- 
munications sets (through 8136's) or up to four 302 communications expansion modules. 

The buffered controllers are connected to the A/Q channel (for transfer of control infor- 
mation) and the DSA bus (for transfer of data). Any program which is running and using 
the CPU continues to run while the controller is handling the data transfer, since the 
A and Q registers are not used during the data transfer. 

Direct memory transfer is done on a cycle- stealing basis; that is, the controller steals 
a memory cycle every time it wishes to transfer a word (through the Z register) . In 
order to calculate how much each buffered controller will slow down the CPU (and, there- 
fore, a running program), a percentage could be figured based on the transfer rate of 
the peripheral. For example, the 1738 is capable of transferring one word every 12. 8 us 
so it will steal approximately every 12th cycle and can therefore slow down a program 
by up to 9% when the disk is running. The program would only be slowed down if the 
CPU and the 1738 both wanted to access memory at the same time. 
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10.4 1706 BUFFERED DATA CHANNEL 
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The 1706 allows direct memory access for unbuffered controllers. It is for any of the 
controllers that are not capable of doing buffered data transfers. (That is, any except the 
1738, 1751 and 1748. ) The 1706 is connected between the 1705 (DSA and A/Q channels) 
and the peripheral controller. 

Only three 1706's are allowed in any system; this is a software limitation rather than a 
hardware limitation. The 1716 is exactly like a 1706 except it is accessible by two 
computers. See note C of Figure 20. The 1706 may control up to eight controllers. 
However, when deciding which peripherals should go on the 1706, it is very important to 
note that it is logically busy the entire time it is handling a buffer transfer for a pe- 
ripheral. During that time it cannot be accessed to do any operation or take status on 
any other peripheral connected to it. Therefore, the timing on the peripherals must bej 
considered so that data will not be lost on one while the 1706 is working on another. 

As a rule, a 1706 would not be purchased to handle relatively slow peripherals (i. e. , the 
1742 line printer or 430 card reader/punch). These peripherals can very effectively be 
operated in interrupt mode as they will interrupt the CPU infrequently to perform their 
I/O. The 1706 would more effectively be used and needed to handle fast peripherals 
(such as magnetic tapes or the 405 card reader). For example, a 1732/608 magnetic 
tape can transfer one frame of data every 32 us. Since MSOS can lock out interrupts 
for up to 50 us at one time, data could be lost on the tapes if they were not connected to 
a 1706. 

Software for controllers operated in the buffered mode through the 1706 should be con- 
sidered on an individual basis in the light of new software releases. 

10. 5 UNBUFFERED CONTROLLERS 

The standard controllers which could be operated in the unbuffered mode through the 
1705 to the A/Q channel are as follows. Most are shown in Figure 20. The newer ones 
are in Figure 21. 

• 1726/405 Card Reader -1200 cpm reader. 405 can also be connected through 1750 
via a 177 controller. Shown on Figure 21. 

° 1728/430 Card Reader/Punch - 500 cards per minute read; 100 cards per minute 
punch, (column punch) . Reader can be purchased separately as a 1729-2, 330-cpm. 
Punch can be purchased separately as a 420A, 100 cpm. 

• 1729-2 Card Reader - this is the replacement for the 1729 and it reads 330 cpm. 
Not shown on Figures. 

• 1731/601 Magnetic Tapes - this is the 1x8 controller for 601 magnetic tapes (200, 
556 bpi). They do not have assembly/disassembly mode. They have been updated 
by the newer 1732/608-609 tapes, and are now available only on a used basis.. 
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1732/608-609 Magnetic Tapes - the new controller, featuring assembly /disassembly 
option, which replaces the 1731. One controller can handle up to eight tape units; 
608' s or 609' s or a combination of both. 

608' s - 7 track; bed or binary; 200, 556, 800 bpi; read forward and reverse 
609 's - 9 track; binary only; 800 bpi only; read forward and reverse 

Software from the 1731/601 is completely upward compatible with 1732 hardware. 

The 1732 is a more expensive controller than the 1731, but the added features 
would be desirable for the more sophisticated user: 

assembly/disassembly mode* 
800 bpi 

forward and reverse read 
9-track tape 

1735/915 Page Reader - optical character recognition equipment, 370 characters 
per second. Software operates as a compiler under Utility System; no standard 
driver is as yet available under MSOS, but it is planned to be added. 

1736-1 OCR Document Reader Controller - controls one 935-1 or 935-2 document 
reader. Software not yet available; will probably run under Utility first. 

1740/501-505 Line Printers - 501, 1000-lpm printer or 505, 500-lpm; 136 char- 
acters. Software not yet available for 505. 

1742 Line Printer (with controller included) - this is the Holley 300-lpm with con- 
trol, 136 columns. 

1744 Digigraphics Controller - controls one 274 digigraphic light-pen console. 
Shown on Figure 21. Software is QSS. 

1745-1 Inquiry/Retrieval Controller - controls 211 Display/Entry and 218 Output 
stations. 

1746-1 Single Station Entry/Display - controls CRT display and keyboard. 

1747 Data Set Controller - controls 301- B data sets. Software runs under Utility 
System. Standard software is available for 6000 import/export. 

1749 Communications Terminal Controller - control s remote communications 
equipment, up to 16 lines per controller. Standard software is available only in 
the unbuffered mode on the 1749; software is not available to connect the 1749 
through the 1706 in a buffered mode. The 1748 is used for buffered operations. 

Standard software is available now or will be shortly on most of the peripherals above 
(except as noted) to run under MSOS in the unbuffered mode. 



*Also, new software for the 1732 utilizing assembly mode will mean the tapes only have 
to be accessed half as often. 



10-4 



10.6 



10.6 160-A PERIPHERALS 
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Several 160-A peripherals are connected to the 1700 on existing configurations through 
a 160-A adapter, and the 1750: 

a) 405 card reader (through 177 controller) 

b) 166 line printer and control 

c) 415 card punch (through 170 controller) 

d) 165-2 Calcomp plotter and control 

These equipments are not listed as standard available products as they are only available 
used on an as-available basis. 

10.7 1500 EQUIPMENT 

The 1500 series of analog equipment for process control is all connected to the 1700 
through different interfaces. A large, detailed chart of 1500 equipment is available 
through ADSD in La Jolla. Much of the series is shown in the Figure 20 chart and its 
primary interfaces are: 

a) 1750 DCB Terminator - this is the prime interface and it allows A/Q channel 
access to the 1500 series via the 1705. It is required if any 1500 equipment is to 
be connected to the computer. 

b) 1797 Buffered I/O Interface - this provides access to the DSA bus for buffered 1500 
equipment. It is functionally equivalent to the 1706 for standard peripherals. It 
is connected to the DSA and the 1750 and it controls up to three 1571's. 

c) 1571 Chaining Buffer Channel - this is the priority buffer channel which assigns 
priorities to the equipment on the 1797. It is required if a 1797 is present. A 
high priority piece of equipment can steal the channel away from a low priority 
equipment. 

See notes E-J of Figure 20. 

One piece of 1500 equipment will be mentioned here as it is nearly always needed in all 
configurations: 1573 Line Synchronized Timing Option. 

This is the clock connected to the 1750 which generates timed interrupts to the CPU 
(60/sec). Any process system which requires a clock for timed programs will need a 
1573 since there is no realtime clock in the computer itself. Many standard systems 
need a clock, especially to monitor I/O which can get hung up (for example, the 1706 
can hang up in a buffer operation if the peripheral malfunctions or drops Ready). Sev- 
eral controllers are capable of generating the necessary timed interrupt, but if one of 
these is not present in the system, the 1573 can be used. 

10. 8 PRIORITIES FOR DSA BUS 

Since all memory accesses, even buffered, must go through the Z register, priorities 
must be assigned to all the interfaces which may use the DSA bus. The 1797 takes 
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highest priority in direct memory access, the 1706 takes second priority, the standard 
buffered equipments (1738, 1751, 1748) take third priority. The running program takes 
lowest priority for accessing memory. On Figure 20, see ®, ®, and (3). 

10.9 SUMMARY, CONFIGURING EQUIPMENT 

The chart in Figure 20 can be utilized very effectively to configure a system. Note that 
low- speed I/O package is connected to the CPU through the Low- Speed I/O Synchronizer. 
Each of the standard buffered equipments (1738, 1751 and 1748) has line connections 
leading to the CPU via the A/Q channel line and theDSA line. The unbuffered equipments 
connect to either the A/Q line or, through a 1706, to the DSA line and A/Q line (to add 
buffer capability). 

The 1750 connects to the 1705 (for A/Q access). The 1797 has lines to the 1750 and DSA, 
and the 1571 leads directly to the 1797. Note that all 1500 peripherals connect either to 
the 1571, 1797 or 1750. The 160-A peripherals connect through the 1750. 

10. 10 RELATED MANUALS 

Additional information on systems configuration will be found in: 

Systems Manual 

Communications Peripheral Equipment Manuals 

ADSD General Information Manual 

Pricing Manual 
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Figure 20 (cont) 



Figure 20 is an overall view of a CONTROL DATiv^ 1700 Computer System; it shows how 
different subsystems are used and the methods by which they can be connected. A few basic 
facts about the CDC® 1700 Computer System are pointed out below. Each statement corres- 
ponds to letters on the block diagram. 

A Up to eight input/output (I/O) controllers can be connected directly to theA/Q channel and 
up to eight I/O controllers can be connected directly to the direct storage access (DSA) 
bus. However, this does not mean that 16 I/O controllers can be directly connected; 
only eight can be connected because each controller that is connected to the DSA bus must 
also be connected to the A/Q channel. 

B Only three CDC 1706 Buffered Data Channels and/or the buffered 1716 Coupling Data 
Channels can be used in a system complex; this is an addressing restriction, not a hard- 
ware restriction. 

C Each Model 1706 or 1716 provides up to eight data channels to which I/O subsystems can 
be connected. Either the 1706 or the 1716 permits the attached subsystems to operate 
via the direct storage access (DSA) bus. 

D The "OR" box indicates that the attached I/O subsystem can either operate through the 
1716 or connect directly to the A/Q channel. Operation via the 1706 is in the buffered 
mode; operation via the A/Q channel is in the unbuffered mode. 

E The CDC Model 1750 DCB Terminator is required whenever a CDC 1500 Series subsys- 
tem is used with the CONTROL DATA 1700 Computer. The 1750 provides a data and 
control bus (DCB) which is functionally equivalent to the A/Q channel. 

F The DCB provides the capability of attaching up to 15 CDC 1500 Series I/O subsystems, 
all of which operate through the A/Q channel via the Model 1750. 

G The CDC 1797 Buffered I/O Interface is required when the attached CDC 1500 Series sub- 
systems must operate through the DSA bus; it provides up to eight priority buffer chan- 
nels to which the CDC 1500 Series equipment can be connected. 

H The CDC 1571 Chaining Buffer Channel connects to one of the eight priority buffer chan- 
nels of the Model 1797. Up to three 1571's can be connected to one 1797. Each 1571 
uses one priority buffer channel. 

NOTE 

If a 1797 is included in a system, the Model 1571 is also required 
to connect existing CDC 1500 Series I/O subsystems. 

I Each 1571 provides a buffered data and control bus (BDCB) to which up to 15 CDC 1500 

Series I/O subsystems can be connected. 

All devices that are shown connected to the BDCB can be connected to the DCB (refer to F, 
above); this means that the 1797/1571 is only required by system definition. 
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C ) Figure 20 (cont) 



J Subsystems connected to the BDCB normally operate through the Model 1797 and the DSA 

bus. However, by program control, they can operate through the Model 1750 and the 
A/Q channel. 

K The 1587A Master Control Panel, 1587B Digiswitch Panel, 1587C Pushbutton Panel, 
1587E Rotary Switch Panel and 1587F Keyboard Panel connect to the 1564A through 
1564H Digital Input Signal Conditioning and operate through the 1544 Digital Input Inter- 
face with the 1545 Digital Input Sync Unit. 

L The 1587G Annunciator Panel receives its information directly from a 1553 External 
Register Output Interface. 



O 



10-9 



1700 HARDWARE CONFIGURATION 



M 

O 



O 



o 
I 






O 

o 

W 
p 
i-i 

P 
CD 

Q 
o 

B. 
p 

e-r- 

o 



Drum Interfj 



OCR 


Documenc 


Reads 


r Controller 


93 5- 


1 line 


935- 


l-311nes 



NOTE: N x M Indication for peripheral 
controller la used to show that the 
controller Bay be driven Iron M channel 
and vlll drive up to K peripherals. 



1704 COMPUTER 



Interrupt Data Channel 
1705 



The following products ha 
direct storage access for 
data transfer: 

1706 1748 
1716 1751 
1738 1797 



4K Storage Incremen 
1708 





Teletypewriter 

100 wpa 

1711 - 35KSR 
1713 - 35ASR 












Paper Tape 
Reader 

1721 - 400 cps 

1722 -w/handler, 

400 cps 










taper Tap. 
Punch 

1723 - 120 cps 

1724 -v/handler 

120 cps 





Up to 3 1706'a may attach to the 1705 




Up to eight peripherals or peripheral 
subsystems may be attached to a single 
1706; or they may be attached directly 



Tape Transport 
601 - 7 track 
7.3 & 
20.8KC 



Tape 


Tra 


nsports 


608 


- 7 


track 


7.5 


, 20 


30KC 


6U Vok3 


track 





Card Reader-Punch 
Controller 

1728 - 1X1 








Card Reader- 
Punch 
433 - 500 cpm 
read 
1C0-40O cpm . 
punch 


















Card Reader 
Controller 

1726-1 - 1X1 








Card Reader 

405 - 1200 cpm 


















tine Printer 

v/Control 

1742 - 300 lpo 














Printer 
Controller 

1740 - 1X1 






Line Printer 
501 - 1000 1pm 













SUBSYSTEMS AND HUTU-SYSTEM F? 
Not supported by standard tsli 



• te ar-ether 17C0 Sy 





A/D Interfa 


« 






[750 - DCB 

Termln 

1797 - Buffer 

1/0 Inte 


d 
fa 


zt 



Satellite Couple 
1718 



Communication 
Terminal 
Controller 



jppor; for the above 
lilarle only vhen they 
1-J5. 



10.10 



V-^ Figure 22 shows the latest configuration of communications equipment through the 

various communications controllers. 
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The following is a systems bulletin describing buffered and non- buffered operations: 

BUFFERED/NON-BUFFERED OPERATIONS 

The purpose of this Data Sheet is to define the terms "Buffered and Non- Buffered" operations 
in terms of hardware. Hopefully, this will eliminate any misconceptions in actual hardware 
operations relative to the terms. It should be made clear that all I/O devices used with the 
1700 Computer are buffered in regard to the handling of data. Each output device or subsys- 
tem has a buffer into which the computer can load data. This is a temporary storage media 
that holds the data while the output device goes through its slow- speed operation using that 
data. During this time, the computer is free to continue on with its program. Each input de- 
vice or subsystem contains a buffer media into which it loads data until the running program 
can accept it as input and during which time the input device is obtaining the next set of data 
for entry into the buffer. 

Non- Buffered Operations 

The term "Non- Buffered" operation is synonomous with "Direct" operation, and means that an 
I/O operation is in progress and data is being transferred during the execution of an I/O in- 
struction via the computer's A/Q Channel. Therefore, data is either being input to the A-Reg- 
ister or output from the A-register. The Q- register, in each case, holds an address speci- 
fying the equipment or device from which the data is coming or to which the data is going. 
Output data goes to a buffer for temporary storage until the device can use it and input data 
comes from a buffer where it has been waiting. This is the Non-Buffered or Direct I/O 
Operation. 

Buffered Operations 

The term "Buffered" operation means that the program has initiated an I/O operation for the 
Direct Storage Access (DSA) bus and is then free to continue its program while the actual data 
transfer is completed. The running program is not interrupted until the entire record has 
been either read or written. Typically, a buffered operation is carried out as follows: 

1) Normally initiated by the computer program executing a "Non- Buffered" input or output 
instruction to a device connected to both the A/Q channel and DSA bus. This Non- Buffered 
output would be the instruction telling the device or subsystem to start operating in the 
"Buffered" mode. 

2) Information supplied to the device during this Non- Buffered operation would be a "Pointer 
Word" that would point to a set of control words located in memory. 

3) These control words may represent the Starting and Ending memory addresses (Record 
length) plus any other information required by the device. They may also represent the 
starting and ending addresses used by the I/O device. 

4) Once the Non- Buffered operation is completed, the program is free to continue its 
function. 

5) When the specified device wants data or has data available, it requests a memory cycle. 
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6) On the next available memory cycle, the data word is transferred to or fetched from the 
memory. Therefore, the program is delayed for one memory cycle each time a data 
word is transferred in or out of memory. This is commonly referred to as cycle 
stealing. 

7) After each data transfer, the device or subsystem increments the current address and 
compares it with the Ending address. Steps 5, 6 and 7 are repeated until the current 
address and Ending address match (held in the 1571 or its equivalent). 

8) When the entire record has been transferred, the Buffered operation stops and the pro- 
gram can be interrupted. 

Direct Storage Access (DSA) 



Direct Storage Access is commonly referred to as Direct Memory Access or may just be 
called a memory channel. The 1700 Computer DSA contains a Data Register, Memory Ad- 
dress Register and control logic which enables attached devices or subsystems to request 
memory cycles and receive access to the memory on a priority basis. The DSA bus always 
have a higher priority than the arithmetic unit. With no Memory request from DSA, the 
arithmetic units requests will continue to be granted for consecutive memory cycles. How- 
ever, a Memory request from the DSA has first priority so that when received, the next mem- 
ory cycle is granted for DSA use. Once the DSA has control of the memory, it would use as 
many memory cycles as necessary to satisfy all requests from the devices on the DSA bus. 
For example, if six devices were attached to the DSA bus and all requested memory at the 
same time, the program would be effectively stalled for six memory cycles (6.6 us) while 
these six requests were serviced. 

Summary 

In summary, a Non- Buffered operation passes data in and out of the A-register via the A/Q 
channel while the Buffered operation passes data in and out of the memory on the Direct 
Storage Access Bus. 
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Advanced coding techniques for the 1700 will be the special considerations needed for 
understanding and writing programs that are part of the system. There are two sep- 
arate libraries of programs : the Program Library and the System Library. 

The programs in the Program Library are relocatable binary programs which are run 
in the background as jobs. This would include such programs as the library subroutines 
needed by the jobs. They are loaded into the unprotected background area of core by 
the loader, for execution, after being called in from the teletypewriter. Jobs could also 
be loaded from the card reader or paper tape reader for execution. 

The programs in the System Library are absolute programs which are part of the system; 
they are run in the foreground in a large area of protected core called allocatable core. 
This would include user process programs. The Operating System contains a directory 
of all the system programs (all the mass memory programs and maybe a few core 
resident programs). This is like a list of all the programs, by module name, and it 
contains the addresses of where they are. The system uses the directory to find the 
programs when it is desired to bring them into core to execute them. 

Protected core is normally synonymous with the foreground, and unprotected core with 
the background. In the background only one program (and its subroutines) would be in 
execution at one time at the lowest priority. In the foreground many programs could be 
in various states of execution at different priorities. The lower priority ones might have 
been suspended (temporarily stopped) while the highest priority one is executed. The 
unfinished programs wait in core to finish execution. If the system needs more allo- 
catable core because it is full, it will"swap out" the entire background area to the Swap 
area on mass memory, protect the background area, and use it for foreground programs. 
When enough foreground programs are completed in order to release the background 
area, that core is unprotected again and the job swapped back in to continue. 

Note that some of the system programs are core resident. The reason all of them are 
not core resident is that they will not all fit in core at once. Therefore, the ones which 
are not needed all the time reside on mass memory in the System Library and are 
called into allocatable core as they are needed. 

In order to understand what all these programs look like and how they execute, as well 
as how they call each other in to core, it will be necessary to study the different kinds 
of programs. 

Emphasis in this chapter will be on system programs as background programs will run 
with any of the coding techniques previously covered. 
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An introduction to the priority structure of the running programs under MSOS will also 
be helpful as an introduction to this chapter. There are 16 program priorities from 15 
(high) to (low). An idle loop runs at priority -1 when the system has nothing else to 
do. These priorities pertain to core resident and mass memory resident programs. 
When a program is running at its priority, it can be suspended by any higher priority 
program which the system allows to run. The suspended program waits in core to re- 
sume execution when the priority structure works back down to it. 

The priority structure can only be changed by interrupts (hardware) or scheduling (soft- 
ware). The mask in the M register allows hardware, which has a higher priority than 
the running program, to interrupt. When an interrupt occurs, the Common Interrupt 
Handler saves all the registers of the interrupted program on the Interrupt Stack (so 
that the program can later be resumed) and transfers control to the program which will 
service the interrupt on the line. 

A schedule request allows a program to change the priority level. If the request is for 
a higher level program, a pseudo interrupt will occur immediately (the suspended pro- 
gram goes on the Interrupt Stack) and the higher level program is executed. Control 
will later return to the suspended program. If the schedule request is for an equal or 
lower level priority, the request parameters go on the Scheduler Stack and are threaded 
in it by priority to be picked up later when the priority structure works down to that level. 

All programs exit to the MSOS Dispatcher. It is the Dispatcher that must cause the next 
lowest priority program to be executed. It does this by looking at the Interrupt Stack 
and Scheduler Stack and finding the highest priority waiting program. 



i 



Interrupts 

from 

Hardware 



Scheduled 
Programs 



Interrupt 
Stack' 



All Programs 
exit to: 



i 



DISPATCHER 



Chooses next 
program from 

t 



Scheduler 
Stack 
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11,1 

11.1 SOURCE, OBJECT AND ABSOLUTIZED PROGRAMS 

11. 1. 1 Source Program 

The source program is the program written in assembly language code by the 
programmer. It most likely would be punched on cards or on paper tape. Here 
is an example of a source program listing: 



r 



0001 










NAM 


SOURCE 


0002 










ENT 


START 


0003 


poooo 


0000 




START 








0004 


POOOl 
P0002 


C400 
0006 


P 




LDA* 


X 


0005 


P0003 


60FF 






STA- 


I 


0006 


P0004 
P0005 


1400 
8000 


P 




JMP* 


(START) 


0007 


P0006 


0010 




X 


NUM 


$10 


0008 










END 


START 



00FF START 0000P X 



0006P 



The source program is read into the computer by the assembler. The computer 
does not execute the program at this time. The assembler translates the 
mnemonics into binary object code. The source program is listed at this time 
(on the teletypewriter or the line printer) and the object program is punched on 
paper tape (or on the disk, drum or magnetic tape) • 

11. 1. 2 Object Program 



It is important to know that the object program is not executed either. It must be 
loaded by a "relocating" loader back into the computer before it can be executed. 
It is not important at this point to be able to interpret the codes in the object pro- 
gram. One must just understand that the codes represent the desired program 
and that the loader will interpret the codes when it loads the object program and 
will make an executable program out of these codes. On the following page is an 
example of how the previous source program would look in object form. 
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Figure 24. Object Tape 



C 



NAM block 



00 
00 
00 
oo 

04 

oo 
oo 

6 
60 
F F 

1 4 
00 
80 
00 
00 
1 



RBD block 



ENT block 



XFR block 



Note that each block on the paper tape is preceded by the one's complement of the 
word count in that block and followed by a checksum word on that block. 
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Figure 24. Object Tape (Cont) 



^ 



NAM BLOCK 



0010 


0000 


0101 


0000 

















7 


s 


o 


u 


R 


c 


E 



1 word = 2 frames on paper tape 



RBD BLOCK 



0100 


0000 


0101 


0000 


0001 


0000 


0000 


0001 


























c 


4 

















6 


0000 


0000 


0001 


1000 


6 





F 


F 


1 


4 








8 

















1 


















ENT BLOCK 



1000 


0000 


0101 


0000 


s 


T 


A 


R 


T 








XFR BLOCK 



1100 


0000 


0101 




s 


T 


A 


R 


T 
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The following is some of the information about the blocks the assembler makes in 
the binary object program for the loader. This was extracted from the Loader 
Chapter of the MSOS Reference Manual, and it may be consulted for more detail. 

Relocatable Binary Input 

The loader recognizes relocatable binary blocks by the type indicator field in 
bits 13-15 of the first word of the block. The following block types are defined: 

Type 



NAM 

RBD 

BZS 

ENT 

EXT 

XFR 



Indicator 


Description 


001 


Name block 


010 


Command sequence block 


Oil 


Zero storage block 


100 


Entry point block 


101 


External name block 


110 


Transfer address block 



If the loader is unable to recognize the indicator, it does not process the block. 
NAM Block 



The NAM block contains a word count for common storage and data storage, the 
program length, and the name of the program. 



0010 


0000 


0101 


0000 


Number of words in common storage block 


Number of words in data storage block 


program length 


character 1 


character 2 


character 3 


character 4 


character 5 


character 6 



Program 

Name 



RBD Block 

An RBD block contains a portion of the actual command sequence data of the pro- 
gram. Words 2-59 contain the relocation bytes and words for the command 
sequence input. Each relocation byte is a 4-bit indicator that identifies a word 
of the command sequence input as an absolute 15-bit address or as a 15-bit address 
relative to some relocation base. The relocation base for a word is determined 
by the particular combination of bit settings within the relocation byte. 

Relocation bytes in RBD blocks : 



0000 
0001 
0101 
0010 
0110 
0011 
0111 



Absolute (no relocation) 
Positive program relocation 
Negative program relocation 
Positive common storage relocation 
Negative common storage relocation 
Positive data storage relocation 
Negative data storage relocation 



X/ 
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0100 


0000 


0101 


0000 


R0 


Rl 


R2 


R3 


WO 


Wl 


W2 


W3 


R4 


R5 


R6 


R7 


W4 


W5 


W6 


W7 


R8 


R9 


RIO 


Rll 
























— 












R40 


R41 


R42 


R43 


W40 


W41 


W42 


W43 


R44 


R45 


not used 


W44 


W45 



Core Image of RBD Block 

Wn nth word of input block, (n=l-45) 

Rn Relocation byte of nth word 

W0 Origin address of input block 

R0 Relocation byte for W0 

There is one relocation byte for every word in the command sequence input, and 
a maximum of 45 words in an RBD block. The first word is the address at which 
the loader begins storing command sequence data. The relocation byte for the 
first word address (storage address) of an RBD block may be 0000, 0001, or 0.011. 
Zero is the leading bit for all but the last relocation byte; one is the leading bit for 
the last relocation byte. 

In processing an RBD block, the loader picks up the 15 bits which represent the 
first word address of the command sequence data in the block. It adjusts this 
address for relocation according to the setting of the bits representing its relo- 
cation byte. The resulting absolute address is the first word address in core to 
receive the command sequence data (stored in consecutive locations). Each word 
is relocated according to its relocation byte. 
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ENT Block 



1000 


0000 


0101 


0000 


name 1 character 1 


character 2 


3 


-4 


5 


6 


El- 


name 2 












E2 


^ 



o 



name 13 



E13 



name 14 



E14 



not used 



not used 



Core Image of ENT Block 

Namen = Six- character name of nth entry in block 
En = Entry point address of nth name 

XFR Block 

The XFR block contains a transfer address (in words 2-4), which is six ASCII 
characters in length, including trailing spaces. The transfer address must be an 
entry point in the program being loaded or in another program loaded during the 
same load operation. 



1100 


0000 


0101 


0000 


Character 1 


Character 2 


3 


4 


5 


6 



J 



Core Image of XFR Block 

The XFR block must be the last in a relocatable binary program. If an XFR block 
is out of order, a loader error message is issued and the load is terminated. The 
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loader records the transfer address in theXFR block. If two or more relocatable 
binary programs are loaded with one operation, the loader saves the last trans- 
fer address for the start of execution. 

It is obvious by looking at the code that it could not be executed exactly as it ap- 
pears. Normally the programmer never has to know what the object tape looks 
like. He would only have to know the format if he wanted to examine parts of the 
tape. For example, if he stored a number of object programs on one tape, he may 
wish to be able to search the tape for a particular program. He could do that by 
writing a program to look at the NAM blocks until it found the right one. 

11. 1. 3 Absolutized Program 

The programmer is, however, very much concerned with how the program looks 
after it is loaded into core for execution. The different addressing modes he used 
when he wrote the source program will determine what the final core image of 
that program looks like. An absolutized program is an exact copy of this core 
image, which can be executed. The loader loads and absolutizes the object pro- 
gram at a certain address, which is wherever it happens to load it. It also links 
the program to any externals and loads and links any library subroutines required. 
A utility routine could be used to punch a tape with this core image on it; hence, 
the term "absolute tape". Here is an example of an absolutized image of the pre- 
vious object program, (if the program was loaded at $1000). 

Op Code 

LDA+ X 



($1000) 


0000 


($1001) 


C400 


($1002) 


1006 


($1003) 


60FF 


($1004) 


1400 


($1005) 


9000 


($1006) 


0010 



STA- I 

JMP+ (START) 

NUM $10 

Notice that the contents of location $1002 is $1006 to indicate where X is and that 
$1005 contains $9000 to indicate the jump through location $1000. The 0006P and 
8000P in the source code were relocated by the loader when the object pro- 
gram was loaded. No matter where the program was loaded, the correct addresses 
would be filled in at that time. 



L 
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Figure 25. Flow of Program Through Execution 
ASSEMBLY TIME 



Source 
Deck 



(read into computer 
by assembler) 



O 



answers 



(generated by program) 



c 



Absolutized 
Program 



unprotected core 




Listing 



(listed by assembler) 
L option 



P option 



object tape 

(written out by assembler) 



object form on 
disk scratch 



X option 



Object tape 



(loaded into computer 
by loader) 
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11.1.4 Form of Programs in MSOS Libraries 

The reason it is so important for the analyst to understand the distinction between 
what the object program generated by the assembler and the absolutized program 
after loading look like is because user and system programs are stored in the 
libraries on mass storage in these two different forms. User background pro- 
grams in the program library are stored in relocatable binary object form. They 
will be loaded by the loader into core whenever they are executed, so they will be 
absolutized and linked each time they are loaded and run. 

System programs (including user process programs) in the system library are 
stored in absolutized form and will be read into core (without any changes) when- 
ever they are needed for execution. This is because it must be possible to bring 
the real time process programs into memory very fast; the relative time it would 
take to load them in with the loader every time they are needed would be too great. 
A much better solution would be to write the source program in such a fashion that 
the absolutized program could be run anywhere in core and would still execute 
properly. The absolutizing of the system process programs is done during system 
initialization (by the loader portion of the system initializer) when the programs 
are stored on the system library. 

11.2 RUN ANYWHERE CODING 

11. 2. 1 Writing Programs for Run Anywhere Coding 

The method devised for writing programs so they can be stored in absolute form 
and still run anywhere in core is called Run Anywhere Coding. It is important to 
know that this is done at the source level. 



Source 



Object 

(J) 

assemble ^ v — ^ y 



Absolute 



load 



anywhere 



Runanywhere or 
not Runanywhere 



Runanywhere or 
not Runanywhere 



Runanywhere or 
not Runanywhere 



The object program can be loaded anywhere and absolutized and will run correctly 
at that time because the loader has relocated any addresses which were in the 
program. However, if an absolute image of this program is later run somewhere 
else in core, it will run correctly if it was coded run anywhere in the original 
source form. Here is an example of the same program coded both ways; (assume 
it was loaded and absolutized at $1000). 
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o 



Not Runany where 



X 



Source 




Absolute 


lRT 





($1000) =0000 


LDA+ 


X 


($1001) = C 4 
($1002) =10 6 


STA- 


I 


($1003) = 6 F F 


JMP+ 


(START) 


($1004) =14 
($1005) =9000 


NUM 


$10 


($1006) =0010 



o 



Source 



START 



X 





Runanywhere 




LDA* 
STA- 
JMP* 

NUM 




X 

I 

(START) 

$10 



Absolute 

($1000) =0000 
($1001) = C 8 3 
($1002) = 6 F F 
($1003) = 1 C F C 
($1004) =0010 



Notice that the addresses of X and START in the first example were relocated by 
the loader to show that X is at $1006 and START at $1000. The program will run 
at $1000, but if, for example, it is moved to $2000 without the object being reloaded, 
it will not run correctly because it will think Xis at $1006 (when actually it moved 
to $2006) and then it will jump through $1000 (when actually the entry point START 
moved to $2000). 

However, in the second example all addressing in the program is relative. The 
LDA* loads from X which is 3 locations forward and the JMP* jumps through 
START which is 3 locations backward. Yet the STA- I must be left as it was 
because the I register is absolute core location $FF, and it will always be there. 
The program is runanywhere because it can be kept in absolute form and can be 
later run anywhere in core with correct results. 

One might at this point wonder why not code all programs in run anywhere form. 
The primary reason is that it is more difficult to learn to do run anywhere coding 
since there are more chances for the programmer to make errors which will not 
produce any error messages. In general, when writing a program to be run 
anywhere, all references to addresses that move with the program should be 
relative, and all addresses which are absolute core locations must be absolute. 
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references to subroutine r* 
of program relative L- ' 



references within 
program relative 



COMMON 



SUBROUTINE 



PROGRAM 



CORE RESIDENT 
PART OF 
SYSTEM 



SCAN 



NAM 


RA 


ENT 


SCAN 


EXT* 


ALARM 


EXT 


LOWPGM 


COM 


X(10) 




1 
LDA+ 

f 

STA- 

I 

LDA+ 

] 

RTJ 

\ 

RTJ+ 



X+0 

$FF 


$10C 

ALARM 

LOWPGM 



END 



references to common 
absolute 



references to low core 
absolute 



relative external 
absolute external 



reference common abso- 
lute 
reference $FF absolute 

reference interrupt trap 

absolute 

reference subroutine 

relative 

reference program- in 

system resident absolute 



Without worrying about the externals at this point, note that all references within 
the program area must be relative. A good way to tell if there are any which are 
not relative is to look at the source listing and see if any of the codes on the left 
are followed by a P, i. e. , in the program SOURCE example, change: 

P0001 C400 LDA+ X 

P0002 0006P f \ 

\ 



to 



P0001 C803 LDA* 



\ 



X 
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Change all loads, stores, jumps, etc. , in the program to relative. 



Look at the VALUE problem from chapter 6 and observe the addressing used in 
the program. COUNT is addressed in two-word relative mode, because the DATA 
block most likely moves with the program and may be further away than 127 ^q 
locations. LPMASK+6 is addressed with one-word absolute mode because it is a 
fixed low core address. MASK in the program is addressed in one- word relative 
mode because it moves with the program. Yet X in the common block must be 
addressed in two- word absolute mode because common is fixed and is in high core. 
The LDA VALUE is in two-word relative mode. This implies VALUE is relative 
to the TEST subroutine and the assembler requires two-word addressing for any 
relative externals. 



O 



o 

11-15 



11.2.1 



VALUE PROBLEM 





NAM 


TEST 




COM 


DUMMY(10),X(10) 




DAT 


DUM(6),COUNT(l) 




EQU 


LPMASK($2) 




ENT 


START 




EXT* 


VALUE 


MASK 


BZS 


MASK(l) 


START 










CLR 


Q 




STQ 


COUNT 




LDA 


VALUE 




AND- 


LPMASK+6 




ALS 


8 




STA* 


MASK 




ENQ 


9 


SEARCH 


LDA+ 


X,Q 




AND 


=N$3F00 




EOR* 


MASK 




SAN 


i 




RAO 


COUNT 




SQZ 


EXIT-*-! 




INQ 


-1 




JMP* 


SEARCH 


EXIT 


JMP* 
END 


(START) 
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11. 2. 2 Buffer Addresses 



O 



Buffer addresses used for indirect addressing (to load or store) in the program 

must be absolutized each time they are used. If the buffer is in low core system 

resident, it can be absolutely addressed: 

I 
i 
EXT BUF 

BUFADR ADC BUF 

i 
I 
I 
I 
STA* (BUFADR) 

i 
i 

The address assembled into BUFADR will be the absolute address of the buffer. 
Since the buffer will never move, even though the program moves, the addressing 
will still be correct. 

However, if the buffer moves with the program, the ADC would not work because 
it would contain the address of where the buffer was when the program was abso- 
lutized. In the following example RELATIVE the buffer BUF is in the program at 
P0007. BUFABS must always contain the address of where the buffer really is. 
If we used: 

BUFABS ADC BUF 

BUFABS would assemble as 0007P which, if the program was absolutized at $1000, 
would contain $1007. Whenever the program moved, the buffer would not be at 
$1007 any more. Neither would the example at P006C work correctly for the same 
reason. 

Study the code beginning at P0000 and see that BUFABS is calculated each time it 
is used. The RTJ* will cause the current address of the BD instruction to be 
stored in BD. (RTJ stores P+l in jump address, then RNI at P+2.) Then the 
LDA calculates the distance from BUF to BD. ADD the contents of BD (the current 
address of BD) and store it in BUFABS to calculate the buffer address! 
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CORRECT 


, 0001 


NAM RELATIVE 




[O 0002 


* 




, 0003 P0000 5801 
0004 P0001 0000 


RTJ* *+l 




BD NUM 




P 7 0005 P0002 C000 


LDA =XBUF-BD 




P0003 0006 






, 0006 P0004 88FC 


ADD* BD 




n '""""0007 " PO'00'5" 6866 


"" STA* BUFAB'S 




, 0008 


* 




0009 


* 




0,„ 0010 P0006 0000 


SLS 




001 1 P0007 0064 


""~BW "B'ZS BUF(IOO) 




„ 0012 P006B 0001 


BUFABS BSS BUFABS(i) 




O """"0013 


* 


INCORRECT 


» PP.14_ ..__ ._ 

0015 P006C C000 


* 




LDA rXBUF 




■ P006D 0007 


P 




"""Wl6" w P0d(S"E"68FCr' 


STA* "BUFABS""" 




14 . 0017 


END 



^. 



The buffer address will be correct whether the buffer is forward from the LDA 
=XBUF-BD or behind it, because of the 15-bit arithmetic used. With BUF in its 
current location the calculation would be 

0007 
-0001 



0006 assembled 
+0001 



0007 



If the buffer were at 7FFE relatively, the calculation would be 



7FFE 
-0001 

7FFD 
+00 01 



assembled 



7FFE 
A very nice way to clean up even the correct code above would be: 





RTJ* 


BUFABS 


BUF 
BUFABS 


BZS 



BUF(100) 
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The RTJ jumps over the buffer, taking the buffer address with it. 
BUFABS, then continues execution following BUFABS. 



11.2.2 



It stores it in 



Look at the peripheral program BOOTSTRAP for the paper tape reader in chapter 
8. Location P0012 is used to contain the buffer address of where the data is to 
read into. Since this address is program relocatable (contains 0014P), the pro- 
gram is not run anywhere because when it is loaded and absolutized P0012 will 
contain the absolute buffer address at that time. If the program and buffer were 
moved, ADDRES would then contain the wrong buffer address. 

More coverage of the externals for run anywhere programs will be mentioned in 
a later section, 11.6. How the externals are written depends primarily on where 
they and the referencing program are in the system. 



O 



11. 2.3 X Bit in System Requests 

In run anywhere programs, the X bit must be used in system requests; and ad- 
dresses used in the requests must follow the same rules for addresses in the 
program which move relative to the program or are external in low core. 

The following example is for the X bit being set in a schedule request: 



RTJ- 

VFD 

ADC* 



($F4) 

N7/9,Nl/l,N8/8 
HELP+1 



/ 







distance 



Since this is a request made from a run anywhere program, the address being 
scheduled, which is HELP, must be relative if HELP is relative to this request. 
(HELP could be in the scheduling program or external to it.) 

When the X bit is used as above to indicate relative addresses, the relative dis- 
tance must be from the first word of the parameter string (not from the RTJ or 
the ADC). That is why the relative address constant (ADC* HELP+1) is coded as 
HELP+1 instead of HELP. The distance established from the ADC to HELP+1 
would be the same distance as from the VFD to HELP, which is the distance 
required by the operating system. 



P0000 






54F4 




RTJ- 


($F4) 


P0001 — 






1308 




VFD 


N7/9, Nl/1, N8/8 


P0002 — i 






0007 




ADC* 


HELP+1 


P0003 










C 




P0004 




7 






i 




P0005 


7 








J 




P0006 










( 




P0007 










j 




P0008 








HELP 






P0009 -J 















( ') 
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Of course, if HELP were a core resident program, it would have to be scheduled 
absolutely from a run anywhere program. It can be scheduled this way e/en if it 
is in the system directory. 



54F4 


RTJ- 


($F4) 


1208 


NUM 


$1208 


7FFFX 


ADC 


HELP 



EXT 



HELP 



When the X bit is set to indicate relative, all addresses in that request must fol- 
low suit. In an I/O request, for example, the completion address and buffer 
address must be relative. Again, they must be relative to the first word of the 
parameter string. 



F WRITE, RP=5, CP=6 





RTJ- 


($F4) 


REQ 


NUM 


$0D56 




ADC* 


COMPL+1 




NUM 







NUM 


$18FC 




NUM 


10 




ADC* 


BUF+5 




[ 




COMPL 


c 




BUF 







ASCII, STD PRINT DEV 



Note that COMPL+1 is used to add 1 to the distance between the ADC* and COMPL 
(to make it relative to REQ). BUF+5 is used to add 5 to the distance between the 
ADC* and BUF. The number of words does not have to be relative even though 
the X bit is set. 

If it is desired to use relative addressing to locate the number of words, it would 
be done as follows: 





RTJ- 


($F4) 


REQ 


NUM 


$0D56 




ADC* 


COMPL+1 




NUM 







NUM 


$18FC 




ADC* 


(N+4) 




ADC* 


BUF+5 


COMPL 


\ 




BUF 





N 



NUM 



10 



11-20 



o 



11.2.3 

All other requests which can utilize the X bit for relative addressing must follow 
the same pattern. 

The ADC* in the above examples will only calculate the correct distance for ad- 
dresses forward_ from the ADC*. Since the relative address must be a 15-bit 
positive increment which is added to P and must work whether the distance is for- 
ward or backward, the following method is often used: 



ADC COMPL-*+l 

or 

ADC BUF-*+5 

The regular ADC form used here has an expression in the address field which will 
always calculate the correct distance. The desired address minus the current P 
counter makes a 15-bit relative distance from P and the adjustment of +1 or +5 in 
the example is for a completion or buffer address. 

Figure 26 shows incorrect examples of relative addressing. See MMPGM in the 
mass memory coding section 11. 5.7 for more examples. Relative addressing is 
detailed in Chapter 8 of this manual. Also, the MSOS Reference Manual contains 
details of using the X bit in all system requests. 
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Figure 26. Error Examples for Incorrect Addressing in 
Mass Memory Programs 



r 



NOTE: 



Buffer is at P0018 

Completion address is at P0012 



0013 
0013 
0013 
0013 

0013 
0013 



0013 
0013 
0013 
0013 

0013 
0013 



P0002 
P0003 
P0004 
P0005 
P0006 
P0007 
P0008 



P0002 
P0003 
P0004 
P0005 
P0006 
P0007 
P0008 



54F4 
0D56 •« 
0012 P 
0000 
18FC 
000A 
0018 P 



FWRITE $FC, WROTE, MSGBUF, 10, A, 5, 6, 1, 1 

X bit set 



> 



j 



> But address still program relocatable 

— Buffer was at P0018 in early example 

FWRITE $FC, WROTE-*+l, (MSGBUF), 10, A, 5, 6, 1, X 

54F4 

0D56 •* X bit set 

000F •* Rel. dist. to WROTE 

0000 

18FC 

000A 

8018 P ■+ Indirect bit on buffer address 



NOTE: 



Buffer is at P0003 

Completion address is at P001D 



0016 WRITE 

0016 P000D 54F4 
0016 P000E 0D56 

0016 P000F 7FEC «* 

P0010 0000 
0016 POOH 18FC 

0016 P0012 000A 

********]3JL********* 

P0013 0000 -* 



FWRITE $FC, *-WROTE-5, *+MSGBUF-5, 10, A, 5, 6, 1,X 
Wrong rel. dist. to compl. 



Illegal relocation to buffer 



0016 ' N. WRITE FWRITE $FC, *-WROTE-5, *-MSGBUF-5, 10, A, 5, 6, 1, X 

0016 P000D 54F4 

0016 P000E 0D56 

0016 P000F 7FEC •< Wrong rel. dist. to compl. (appears backward) 

P0010 0000 

0016 POOH 18FC 

0016 P0012 000A 

P0013 000B ■* Backward rel. dist. to buffer (appears forward) 
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Problem: Write a runany where program. 

Given: skeleton of a program which computes an average of 10 positive numbers. 



AVG 



LOOP 



TEST 



o 



AV 



NAM 


AVERAGE 


ENT 


AVG 


BZS 


OVFL(l) 








ENQ 


9 


ENA 





sov 





ADD* 


X,Q 


SNO 


TEST-*-l 


RAO* 


OVFL 


AND 


=N$7FFF 


SQZ 


AV-*-l 


INQ 


-1 


JMP* 


LOOP 


LDQ* 


OVFL 


ALS 


1 


LRS 


1 


DVI 


=N10 


JMP* 


(AVG) 


END 


AVG 



o 
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a. Write a main program, with a buffer with data in it, to call AVG as a sub- 
routine. Set up the proper linkage between the main program and its sub- 
routine. The main program should punch the answer (the average of the data) 
on binary paper tape. * Be sure the programs work before going further. 

b. The programs should be coded in runanywhere form and should not destroy 
themselves. 

c. To checkout the runanywhere features of the programs add a move subroutine 
to move the main program and AVG to a higher core area after they have run 
once and given one answer. Then control should be transferred to the entry 
point of the main program at its new address to run it again and see if it 
gives the same answer. 

This will simulate a runanywhere mass memory module being executed in a 
different core area, and it can be checked out in the background with the 
protect switch set. 

If CONVRTis used, it should not be moved in the move and should be addressed 
absolutely. This is because it is not runanywhere. Using CONVRT would 
simulate a mass memory module calling a core resident subroutine which 
remains at a fixed location even though the module runs indifferent locations. 

11. 3 REENTRANT CODING 

It is necessary in a real time process environment for many of the programs to be 
reentrant. This is because the process programs run at different priority levels and 
may have common subroutines. A reentrant program is one that can be entered at more 
than one priority level. The program may begin its computations but be stopped (per- 
haps as a result of a hardware interrupt at a higher level). Then it may be entered 
again at a higher level (perhaps by being called by the higher level interrupting pro- 
gram). It must do a computation for the higher level calling program. Then it must 
resume the original computation later without losing any continuity or results. An 
example of a situation in which a subroutine PGM must be reentrant is as shown on the 
following page. 



*The main program could instead call the CONVRT conversion subroutine to convert the 
hexadecimal answer to ASCII codes, then write it in ASCII on the teletype. 
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(Priority 4) 



O 



© 



Program A 



© 



(Priority 6) 
Program B 



RTJ+ 



Exit 



PGM 

© 



RTJ+ 



PGM 



© 



©nc^ 



hardware 
interrupt " 



© 



PGM 

© 



Exit 



I @Exit_sL/j 

1. Program A runs at Priority 4 and 

2. calls PGM (at same priority). 

3. PGM is running when 

4. an interrupt occurs. 

5. Program B begins to run at priority 6 (higher) as a result of the interrupt, and 

6. it, too, calls PGM. 

7. PGM must run a calculation for program B and 

8. return to program B. 

9. Program B must complete and exit. At that time 

10. the priority drops back down to 4, and PGM resumes its computation for program 
A where the interrupt occurred. It must correctly complete its run for A and 

11. return to program A. A then can 

12. complete and exit. PGM must be reentrant so it can make correct computations 
and exits for A and B. 
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11. 3. 1 Methods of Reentrants 

There are a number of different methods which are used to make programs 
reentrant. 1700 MSOS provides for reentrant programs by containing a core 
area called Volatile Storage which any protected program may use. Volatile 
storage is actually a BSS block in the program VOLA and its size is set up at 
system initialization time. A program can establish its reentrancy by requesting 
a temporary area of volatile storage for each run in which to store its temporary 
results during execution. No locations in the program area can be used for 
temporary results because they would be destroyed if the program was reentered 
before it completed execution. Therefore, all data would be either in volatile 
storage or in the registers. (P,A,Q and I would be saved in the interrupt stack if 
an interrupt occurred. ) 

The following program can be used as an example and it will be recoded to be 
reentrant. The addresses of two parameters which are to be added together by 
the subroutine are passed in A and Q. The answer is to be passed back in A. 



ADD2 



NAM 


ADD2 


ENT 


ADD2 








STA* 


TEMP 


STQ* 


TEMP+1 


LDA* 


(TEMP) 


ADD* 


(TEMP+1) 


JMP* 

? 

BSS 


(ADD2) 


TEMP(2) 


END 





STORE ADDRESSES OF 
PARAMETERS. 
PICK UP PARAM 1 
ADD PARAM 2 
RETURN WITH ANSWER 
IN A 



The program as it is written above would not be reentrant because its return ad- 
dress and parameter addresses would be lost if the program was reentered before 
it was finished. 
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o 



o 



The following is the program coded in reentrant form. 



1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 
10. 
11. 
12. 
13. 
14. 
15. 
16. 
17. 



ADD2 



EXIT 



NAM 


ADD2 


ENT 


ADD2 


EQU 


AVOLA($BB) 








UN ■ 




RTJ- 


(AVOLA) 


NUM 


4 


EIN 




LDA* 


ADD2 


STA- 


3,1 


LDA- 


(ZERO),Q 


LDQ- 


1,1 


ADD- 


(ZERO),Q 


STA- 


1,1 


LDQ- 


3,1 


IIN 




STQ* 


ADD2 


RTJ- 


(AVOLR) 


EIN 




JMP* 


(ADD2) 


END 





AVOLR($BA), ZERO($22) 
ENTRY POINT "^ 

LOCK OUT INTERRUPTS 
GO GET SOME VOLATILE 
4 WORDS WANTED 



PICK UP RETURN ADDRESS 
SAVE IT IN VOLATILE 
GET PARAM 2 IN A 
GET PARAM 1 ADDRESS IN Q 
ADD PARAM 1 TO PARAM 2 
PASSANS. BACK IN A 
PICK UP RETURN ADDRESS 

STORE RETURN ADDRESS 
GIVE BACK VOLATILE 
ENABLE INTERRUPTS 
EXIT 






J 



-\ 



)>X 

H 



J 



4-word volatile storage block 



(I) + 



3 


Return 


«« 






I 


> 


2 


^ 


1 


A 




1 





Q 






J 



calling program's registers 



/ 

Subroutine ADD2's I register contains volatile address. 

A separate 4- word block of volatile storage will be assigned each time the program 
is reentered. Since its I register is always saved when an interrupt occurs, the 
value of I in each run will locate the specific block being used in that run. 

Success ive blocks allocated will always be to higher priorities and, naturally, 
release will be in reverse order. 



w 
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$1008 



$1004 



$1000 



Return 
I 

A 
Q 



Return 
I 

A 
Q 



Return 
I 

A 
Q 



Volatile assigned on 3rd entry; 
i.e., at priority6, I register 
contains $1008 



Volatile assigned on 2nd entry; 
i.e., at priority 5, I register 
contains $1004 



Volatile assigned on 1st entry; 
i.e., at priority 4, I register 
contains $1000 



Lines 1 through 7 in the example ADD2 program could be the same in any re- 
entrant program consisting of getting volatile storage* for that run and saving the 
return address. Lines 12 through 17 could be the same also, consisting of 
returning the volatile and exiting. Lines 8 through 11 comprise the program 
itself. Note that in this case no TEMP's were needed because the parameter 
addresses in the calling program's A and Q registers are contained in volatile 
locations 1 and and they can be used to access the parameters. The following 
is a line-by-line description of the reentrant coding for the ADD2 program. 

1. The entry point is entered by a RTJ from the calling program. 

2. The subroutine must lock out interrupts because the return address which the 
RTJ stored in the entry point must not be lost. Since the RTJ instruction 
stores its return address in the jump address and does an RNI at jump ad- 
dress+1 (line 2, the UN) an interrupt cannot occur and wipe out the return 
address in ADD2 before the UN. The UN must also be in effect before the 
RTJ to VOLA because VOLA is not reentrant and expects interrupts to be 
locked out before it is entered. 

3,4 Jump to VOLA (through locore location $BB). Pass a parameter to VOLA 
requesting four words of volatile storage. A different block will be assigned 
each time this subroutine is entered, and the address of the block comes to 
the calling program (ADD2) in I. ADD2 must never destroy its I register 
because it contains the address of the volatile block. VOLA also saves the 
calling program's Q, A and I registers in the first three words of the block. 

All the registers inADD2 (including I) will always be safe from an interrupting 
and reentering program because ADD2's registers would be saved on the 
interrupt stack. 
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5. Enable interrupts as soon as possible because it is illegal to lock them out 
for more than 50 us (including the time in VOLA). 

6. One free instruction is allowed after theEIN before an interrupt can occur; so 
the return address is rescued from the entry point — it will be safe in A. At 
any time after this point an interrupt can occur and the Interrupt Handler 
will save the registers. 

7. Store the return address in volatile so that the A register can be used in the 
program. 

8. Q still has the address of parameter 2 in it from the calling program so it can 
be used to get the parameter into A. 

9. The address of parameter 1 was passed in A and VOLA put it in the 2nd word. 
It can be loaded into Q. 

10. Parameter 1 is then added into A using the address in Q. Note in 8 and 10 
that the addresses are put in Q. One way of addressing the parameters which 
would not work is : 

LDA- (1+1) 

ADD- (1+0) 

It looks like it would work because the addresses are in 1+1 and 1+0 but this 
would be assembled as $100 and $FF which of course is not where the ad- 
dresses are. An assembty error would probably occur at the 1+1. Another 
method which would not work is: 

LDA- ($3), I 

ADD- ($22), I 

Location $3 has a 1 in it to which will be added the contents of $FF (giving 1+1) 
and the add would be from 0+ the contents of $FF (giving 1+0). This would 
get the parameter address in A. Then the ADD would add in the second 
parameter address. 

11. The answer is stored in volatile+1 because that is where VOLR will restore 
the A register from. Any parameters to be returned in registers must be put 
in the first three words of volatile. 

12. The return address must be picked up out of volatile because volatile is going 
to be returned and it would be lost. 

13. Interrupts are locked out for exiting. 

14. The return address is stored in ADD2 because the original Q is going to 
replace ADD2's Q. 
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15. Volatile is returned. VOLR restores the original registers from the first 
three words of volatile ! That is why the answer was put there, to get it in 
the original A. Also, since volatile is now gone, the return address had to 
be rescued; and it could not be left in Q (to exit through Q) because ADD2 f s 
Q is gone. 



16. 


Enable interrupts. 






17. 


Free instruction to exit. 
Incorrect example: 








line 10 ADD- 


(ZERO),Q 


ANSWER IN A. 




LDO- 


3,1 


RETURN ADDR IN Q 




RTJ- 


(AVOLR) 


RETURN VOLATILE 




EIN 








, ► JMP* 


(ZERO),Q 





Q now has the original Q in it, not the return address; also the answer in A 
was clobbered and has the original A in it. 

]f any other temporary locations were needed by the reentrant program, they 
would be requested in volatile and would be addressed the same way. For ex- 
ample, if it was desired to move the parameter addresses to volatile +5 and 6 
(like TEMP's in non-reentrant program), the NUM in line 4 would be 6 and lines 
8 through 12 would be replaced with: 

PICK UP PARAM 1 ADDRESS 

MOVE TO TEMP (1+4) 

PICK UP PARAM 2 ADDRESS 

MOVE TO TEMP+l(I+5) 

GET PARAM 1 ADDRESS IN Q 

GET PARAM 1 

GET PARAM 2 ADDRESS IN Q 

ADD PARAM 2 TO PARAM 1 

STORE ANSWER TO PASS IN A 



LDA- 


1,1 


STA- 


4,1 


LDQf 


0,1 


STQ- 


5,1 


LDQ- 


4,1 


LDA- 


(ZERO),Q 


LDQ- 


5,1 


ADD- 


(ZERO),Q 


STA- 


1,1 
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5 

4 

3 

2 

1 

(I) + 



address of 
parameter 2 



address of 
parameter 1 



return 



A 



Q 



O 



This example coding (immediately above) is used simply to illustrate how the 
program can access volatile for its temporary results. Of course, it would be 
inefficient to code the present example this way because the move and reloading 
are not necessary. Study all the addressing carefully. 

11.3.2 Reentrant Problem, A VG 

Following is the AVG program which computes an average. Rewrite the program 
as a non-destructive and reentrant subroutine. Assume that the calling program 
passes the number of words in A and the first word address in Q to the subroutine. 
The subroutine should pass the average back in A and the remainder in Q. Re- 
member that interrupts may not be inhibited more than 50 us at any one time. 



AVG 



LOOP 



TEST 



AV 



NAM 


AVERAGE 


ENT 


AVG 


BZS 


OVFL(l) 








ENQ 


9 


ENA 





sov 





ADD* 


X,Q 


SNO 


TEST-*-l 


RAO* 


OVFL 


AND 


=N$7FFF 


SQZ 


AV-*-l 


INQ 


-1 


JMP* 


LOOP 


LDQ* 


OVFL 


ALS 


1 


LRS 


1 


DVI 


=N10 


JMP* 


(AVG) 


END 


AVG 



o 
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11.4 MSOS REQUESTS MADE BY SYSTEM PROGRAMS 

Remember that all requests to MSOS simply put a desired action (such as a Write or 
Schedule) on a list (queue) and that the action may or may not be performed (depending 
on the rules) before control returns to the requestor. 

There are special considerations system programs (either core resident or mass 
memory resident) must make when making requests to the operating system. This is 
in addition to the considerations and rules jobs must follow. 

First, all protected programs must check a request after it is made to see if it was 
accepted. When control is returned to the requestor beneath the parameter string, Q 
will be positive if the request was accepted, negative if the request was rejected. For 
example: ^ 

RTJ- ($F4) 1 

NUM $1206 > schedule request 

ADC PGM J 

CKQ SQP REQOK-*-l 

JMP* REQREJ 
REQOK J" 

In the above example when control is returned at CKQ, a skip is made to REQOK if, 
indeed, the request was accepted. Otherwise, (Q negative) a jump is made to REQREJ 
because the request is rejected. If a request is rejected, the program might either 
repeat the request at REQREJ, change the priority, or print an error message. Re- 
member that when a job made a request, the system would continually repeat the request 
until it was accepted, then return control to the program beneath the parameter string. 
However, all protected programs should check every request in the above fashion since 
there will be no other indication if a request is rejected. 

Even though a bit of Q is used to indicate acceptance or rejection of a request by the 
system, if the program were passing a parameter in Q, the full 16 -bit original Q is still 
passed intact. Only the upper bit has been changed when control comes back to the re- 
questor. 

11.4.1 Schedule 

A schedule request made by a system program would be coded the same as one 
made by a job except the requestor should check to see that it is accepted. Ex- 
amples would be: <- 

RTJ- ($F4) 

NUM $1205 

ADC WRITE 

SQP OK-*-l 

JMP* REJ 
OK 5 

WRITE is in the scheduling program. It will be executed at priority 5. 
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OK 
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EXT 

RTJ- 

NUM 
ADC 


MIPRO 

($F4) 
$1204 
MIPRO 


SQP 
JMP* 


OK-*-l 
REJ 



o 



MIPRO is external to the scheduling program and will be run at priority 4. 
core resident and not in the system directory. 

f- 

EXT MIPRO 

f 

RTJ- ($F4) 

NUM $1204 

ADC (MIPRO) 

SQP OK-*-l 

JMP* REJ 

T 



It is 



OK 



Here MIPRO is in the system directory and will run at 4. The MIPRO program 
could be either core resident or mass memory resident. The scheduling program 
does not have to know where MIPRO is as the system will find it. 

There is an important consideration to make when deciding whether to schedule a 
program with the regular external form or whether to schedule it with the system 
directory form (having the program in the system directory). If it is undecided 
whether the scheduled program will be core resident or mass memory resident, 
use the system directory form as it will work in either case. The same logic 
would apply to a core resident program which may later be a mass memory pro- 
gram. Using the system directory form simply causes the system to have four 
more words of core (for the directory entry) and take a few microseconds longer 
to schedule but this can save miles of recoding. 



o 
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11. 4. 1. 1 Priorities (Schedule) 

The system program will be concerned with the priorities of the scheduled pro- 
grams. The software priorities run from 15 (highest) to (lowest). The CP 
(completion priority) field in the request is the desired priority for the address 
scheduled. This means that scheduling is actually like jumping to an address and 
changing the running priority concurrently. 

If the priority in the schedule request is lower than or equal to the current running 
priority of the program making the request, the scheduled program will run after 
the current program is finished and the priority works down to it. It waits by 
priority in the scheduler stack with other scheduled programs. This is the way to 
set up things to be done after the current program exits. 

If the scheduled priority is higher than the running priority, a pseudo interrupt 
occurs immediately and the scheduled program is executed. Then control returns 
back to the requestor. 

Process programs usually run at priorities of 4, 5 and 6. Jobs run at and 1. 
Other priorities are usually for the operating system and hardware interrupts. 

11. 4. 1. 2 Rejects (Schedule) 



A scheduled request for a core resident system program which is not in the sys- 
tem directory would be rejected if there is no room in the scheduler stack (the 
queue for waiting scheduled programs) for the request parameters. If the request 
is for a program which is in the system directory and that program is already 
threaded on some thread, a reject would occur. This implies that the program 
has been scheduled (perhaps by some other program) and not yet finished. Pa- 
rameters for schedule requests for system directory programs are not transferred 
to the scheduler stack so a reject would not occur as a result of the scheduler 
stack being full. 

At this point it could be noted that relatively minor modifications to the system 
would be required to allow for a queue of requestors waiting to rerun a desired 
system directory program (for example, a mass memory program which is already 
in core). It would even be possible to allow that mass memory program to be re- 
entered by a higher priority interrupting program (in which case it would have to 
be reentrant). 

11. 4. 2 TIMER Request 

Since TIMER requests are simply delayed scheduler calls, they may be made by 
system programs with the same considerations as required for scheduler calls. 
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11. 4. 3 I/O Requests 

The I/O requests (READ, WRITE, FRE AD, F WRITE) must consider priorities 
when these requests are in protected programs They must also check to see if 
the requests were accepted. The actual operation of what the requests do is the 
same as for jobs. 

The following is an F WRITE example: 



O 





RTJ- 


($F4) 






NUM 


$0C76 


F WRITE, RP=7, CP=6 




ADC 


WROTE 


COMPLETION 




NUM 









NUM 


$18FC 


ASCII MODE, STD. PRINT DEVICE 




NUM 


35 


35 WORDS 




ADC 


BUF 


BUFFER ADDRESS 




SQP 


OK-*-l 






JMP* 


REJ 




OK 


1 


T 




WROTE 


BSS 


1 

BUF(35) 




BUF 






END 






11.4.3.1 Priorities 


(I/O) 







The request priority (RP=7 in example) has absolutely nothing to do with the 
running priority of the program. It is the priority of this request with respect to 
other requests for a logical unit number. In other words if there are RP=6 and 
RP=10 requests waiting to be written on the printer, the RP=7 requests will be 
threaded in between the 10 and the 6. Each logical unit has a queue of requests 
waiting for it and the driver will handle them sequentially by priority. When the 
write actually gets done is a function of the driver (program) priority and its re- 
lationship with the priority of the running program. For example, if the teletype 
driver runs at priority 10 and the program runs at priority 6, the driver will 
periodically interrupt the program to do the actual write operation. 

The completion priority in the requests (CP=6 in example) is related to the running 
priority of the program. It is like a schedule request for the completion address 
after the I/O is finished, hi the example, if the running priority is 4, a pseudo 
interrupt will occur and the priority will be changed to 6 when the I/O is finished 
and the completion routine entered. 



o 
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From the time the request is initiated until the time the I/O is completed, the 
thread word in the request will be non-zero. Here is an example of a program 
which runs at priority 4, initiates a request, and loops waiting for the request to 
be finished. 



F WRITE, RP=14 

NO COMPLETION 

THREAD 

ASCII, OUT ON TTY 





RTJ- 


($F4) 




NUM 


$0CE0 




NUM 





THREAD 


NUM 







NUM 


$0804 




NUM 


35 




ADC 


BUF 




SQP 


LOOP-*-l 




JMP* 


REQREJ 


LOOP 


LDA* 


THREAD 




SAZ 


COMPL- *-l 




JMP* 


*-2 


COMPL 







REQUEST ACCEPTED 

THREAD ZERO YET? 
SKIP OUT; I/O DONE 



Many programs have been coded this way; and this should not be done. Looping 
like this at any priority is going to slow down a system by locking out lower 
priorities. For example, if many process programs were coded this way, they 
could almost completely lock out job processing (which runs at and 1). It would 
be much better to code the write with a completion address and jump to the dis- 
patcher to wait for the completion routine to be entered. 

It is important to control the priorities in a program which makes a number of I/O 
requests. Completion routines should be very short and should be at a higher 
priority than the rest of the program to cause a software interrupt in the program 
when I/O is complete. Completion priority could be lower than running priority 
if it is simply desired to check for errors at the end of the program or if it is 
desired for the programs handling the data to run lower. 

If a program is to run at priority 4 and all its I/O completion is to run at priority 
5, it would be necessary for each completion routine to schedule the priority back 
down to the program priority before initiating the next request. 
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O 





EXT 


REJ, IOERR 






EQU 
RTJ- 


ADISP($EA) 






($F4) 






NUM 


$0875 


FREAD, CP=5 




ADC 


COMPRD 


COMPLETION 




NUM 









NUM 


$1005 


ASCII, LUN 5=CR 




NUM 


40 


40-WORD BUFFER 




ADC 


BUF 






SQP 


REQOK 






JMP+ 


REJ 




REQOK 


JMP- 


(AD ISP) 




COMPRD 


SQP 


SCHPRT 


PRIORITY HERE IS 5 




RTJ 


IOERR 




SCHPRT 


RTJ 


($F4) 






NUM 


$1204 


SCHEDULE, DOWN TO 4 




ADC 


PRINT 


PRINT IN SAME PGM 




JMP- 


(AD ISP) 




PRINT 


RTJ- 


($F4) 


PRINT NOW AT PRIORITY 4 




NUM 


$0C05 


F WRITE, CP=5 




ADC 


COMPPR 






NUM 


0, $1004, 35 


LUN 4 (TTY), 35 WORDS 




ADC 


BUF 





11.4.3.2 Rejects (I/O) 

An I/O request could be rejected if the request is already threaded (like if the 
program tried to start up that write again before it was finished) or if the system 
tries to schedule the driver and finds the scheduler stack full. (In that case the 
driver's priority would be lower than the running priority of the program and that 
is not normal. ) 



■^/ 
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11. 4. 3. 3 System Request Problem, THREAD 

The following example program runs at priority 12 and makes a Write request for 
the teletypewriter (logical unit 4) at priority 14. Since it has no completion ad- 
dress, it does not jump to the dispatcher to wait for the Write to be finished as 
control would not return to the program. Instead, it waits for the Write to be 
finished by looping on the thread word at LOOP. (The thread word was filled when 
the request was made and becomes zero again only when the driver has finished 
this request.) The driver runs at priority 10. 





RTJ- 


($F4) 






NUM 


$0CE0 


FWRITE, RP=14 




NUM 





NO COMPLETION 


THREAD 


NUM 





THREAD 




NUM 


$1004 


ASCII, OUT ON TTY 




NUM 


35 






ADC 


BUF 






SQP 


LOOP-*-l 






JMP* 


REQREJ 




LOOP 


LDA* 


THREAD 






SAZ 


COMPL- *-l 






JMP* 


*-2 




COMPL 









When will the write actually be done ? 
11. 4. 4 EXIT Requests 



All programs exit to the dispatcher. This is so the dispatcher can pick up the 
highest priority program waiting to be executed next, whether it is a previously 
interrupted program or a scheduled program. This is how the priority drops. 

The EXIT request made by an unprotected program generates a jump to the dis- 
patcher. A protected program may not use the EXIT request; it must code the 
jump to the dispatcher: 



f 

EQU 

JMP- 
END 



ADISP($EA) 
(ADISP) 



11.4.5 SPACE and RELEASE 

There are two requests which only protected programs are allowed to make: Space 
and Release. These requests are used to get, and later release, core in the pro- 
tected area called allocatable core. Any unprotected program may access this 
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area and may use the space for anything it desires — to contain data or programs. 
The allocatable core area is divided into priority blocks (so that some core will 
always be available at the highest priorities). The sizes of the blocks at each 
priority are set up by the systems analysts at system initialization time. 

11. 4. 5. 1 SPACE Request 



Here is the format of the SPACE request: 
RTJ- ($F4) 

15 9 8 4 



RC=10 



RP 



CP 



COMPL 



THREAD = 



Q 



N WORDS 



The Macro form for the SPACE request would be: 

SPACE n, compl, rp, cp, X 

RC is request code 10. Bit 8 is X bit. 

RP is priority of the block in which space is desired. 

CP is the priority of the completion address. 

COMPL is the completion address of where control will go after the space has 
been gotten. 

THREAD is the thread word, zero. 

Q is the Q register parameter passed back to the completion routine. Q will 
contain: 

address - of the space gotten, or 

$8000 - if no space will ever be available at this priority; this means 

that even if the background were swapped out there would still 

not be enough core to fill the request. 

N WORDS is the number of words of space requested. 

The address of the space would also be in core immediately preceding the space 
block which was acquired. 



o 
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r 



~i 



FWA 



FWA 



">i 



> BLOCK 



J 



A swap would occur if necessary to get core under the following conditions: 

Request priority is greater than 3 

Completion priority is greater than 2 

Core is not already swapped 

No unprotected I/O is going on 

The minimum time between swaps is passed 

Otherwise, the request for space waits on a queue. 

The space request would only be rejected if it was already threaded, (i. e. , still 
involved in a previous operation. ) 

11.4.5.2 RELEASE Request 

After the program which requested the space is finished using it, it must release 
the space. This is done with a RELEASE request. The format of the release 
request is as follows: 



RTJ- 



($F4) 



15 




9 


8 




1 







RC = 12 







t 


FWA 



The Macro call for RELEASE is: 

RE LEAS fwa,t,x 
RC is request code 12; bit 8 is X bit. 
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M^bit, bit 0, should be if it is desired for control to return to the program 
(releasor) after the release is made. The 't' bit is set to 1 if control should go to 
the dispatcher instead. The release request is the only one which allows this 
choice of whether to come back to the program beneath the parameter string (as 
all other requests do) or to go to the dispatcher if this was the last thing to do. The 
't' bit will be used in coding mass memory programs. 

FWA is the address of the core to be released. It must be the correct address of 
the block or else no release will occur and there will be no error message. This 
is to provide flexibility so that a program which was coded to run on mass memory 
(in a later section) could be changed to be core resident without any changes or 
reassembly of the program. When it became core resident and tried to release 
its core, the core simply wouldn't be released. 

The release request causes the space to be immediately given to any other space 
requestor waiting on the space queue before control returns to the releasor (or 
dispatcher) . 

An example of a space and release request could be: 

f 



1. 



2. 



3. 



4. 
5. 





RTJ- 


($F4) 




NUM 


$1445 




ADC 


COMPL 




NUM 







NUM 







NUM 


$1000 




SQM 


REJ 




JMP- 


(ADISP) 


COMPL 


SQP 


GOTSP- *-l 




JMP* 


NOSPAC 


GOTSP 


STQ* 


REL+2 



RP=4, CP=5 
COMPLETION ADDRESS 

ADDRESS COMES BACK HERE 

$1000 WORDS WANTED 

REQUEST REJECTED 

WAIT FOR SPACE 

GOT SOME SPACE 

NO SPACE GOTTEN 

ADDR. OF SPACE IN RELEASE 



6. 


REL 


RTJ- 


($F4) 


GO RELEASE SPACE 


7. 




NUM 


$1800 




8. 




NUM 





ADDRESS OF SPACE 



9. 
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END 
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1. 
2. 
3. 

4. 



5. 
6. 

7. 



9. 



Space request, priority 4 block, completion priority 5 
Q is checked to see if request was not accepted. 

Completion address is entered when space is gotten or if there is no space. 
Q would be negative if no space was obtained. 

If space was obtained, Q contains the address of the block. Here it is stored 
in the release request. The address could also have been obtained later from 
word 3 of the space parameter list. 
Continue in program, using space. 
Release the space; program is finished using it. 

't T bit is not set, so control returns to the program after the release. 
The address of the block is here; it was placed here after the space was ob- 
tained. 
Continue in program. 



Note that the above program is not runanywhere so it must be a core resident sys- 
tem program. The completion address in the space request is not relative. 

11. 5 CODING MASS MEMORY PROGRAMS 

All programs that are to be part of the System Library resident on mass memory must 
conform to special rules. All of the rules are logical when the inter-relationship of the 
program and the system is considered. The most important general consideration is to 
be sure the program gets to do everything it set out to do before it disappears. 



c 



11.5.1 Modules in Library 

The programs are stored on mass memory in absolutized form. (The System 
Initializer put them there.) Each program - or a set of a program and its sub- 
routines together - is called a module and has a name unique to the module. The 
name must not appear as an entry point anywhere in the system. The name of 
the module must be in the system directory. Here is an example of two modules 
on mass memory: 



MIPRO 
Module 



MIPRO 
Program 



(MIPRO is not an entry 
point. ) 



r 



SCAN 
Module 



< 



\. 



SCAN1 
Program 



SCAN2 
Subroutine 



SCAN3 
Subroutine 
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MIPROis the program which handles manual interrupts to the process; the module 
is made up of the single program. SCAN is a module made up of a user process 
program SCAN1 and its subroutines SCAN2 and SCAN3. These three programs go 
together and will always be together as a group when the module is brought into 
core for execution. 

It is possible for a mass memory module to contain a DATA block within it, ac- 
cessible only to the programs in that module. Any number of modules may contain 
separate DATA blocks, but there may be only one in each module. Here is an 
example of the SCAN module if it contained a DATA block: 



SCAN3 



SCAN2 



SCAN1 



DATA 



The programs in any module may use system COMMON, which is in highest core. 



O 



11.5.2 Allocatable Core 

The area of core that the mass memory programs run in is called allocatable 
core. It is divided into priority blocks and the highest core area is available to 
the largest priority programs. A program to be run will be put in the smallest 
space it will fit in which is available to that priority. Note that this means a pro- 
gram may run at different places in allocatable core at different times. There is 
no dynamic relocation of the programs in allocatable core so as core spaces are 
released, they are saved for subsequent programs to be run in. 



Time 2 



Time 1 





MIPRO 


1 


^Z^VV 


^ 


MIPRO 



*\ 



> 



area of allocatable core 
available to priority 4+ 



J 



o 



In the above example MIPRO may run in different places depending on the space 
available. 
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The systems analysts decide what priority area the program will run in (at system v_. 

initialization time); so a program calling a mass memory program has no control 
over this. 

11. 5. 3 Scheduling the Mass Memory Program 



When it is desired to bring a mass memory program into core for execution, the 
calling program schedules it in. An example would be: 

EXT MIPRO 

1 

SCHDLE (MIPRO), 4,0 

The system program MIPRO is scheduled in, to be executed at priority 4. As in 
all requests for system programs, MIPRO must be named external and must be in 
parentheses in the SCHDLE request. 

The name MIPRO is the name of the module in the system directory. This re- 
quest causes the system to obtain space in allocatable core to put the program in 
(by a SPACE request), then to read it in (by a mass memory READ request), then 
transfer control to it at its first core location. 

The calling program does not have to worry about all this; it s imply knows that 
scheduling it causes the program to come in to core and begin execution. The 
schedule request would be rejected if the program has already been scheduled (by 
another caller) and is still in the process of being brought into core. It could not 
be rejected from the scheduler stack being full because the parameters are not 
transferred to the stack. 

11. 5. 4 Form of Mass Memory Programs 

All mass memory programs have to be runanywhere, as has already been covered. 
This is because they are stored on the system library in absolute form and are 
run at different places in allocatable core, not where they were absolutized. 

Mass memory programs do not normally have to be reentrant because a program 
is usually brought into core each time it is called to be run. Minor modifications 
to the system would be required to allow a mass memory program which is in 
core to be reentered by a higher priority interrupting program; in that case it 
would have to be reentrant. 
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Figure 27. Maps of Mass Memory Modules and Core Subroutines 




Module SCNMSG could be scheduled by 
any routine in either SCAN or ALARMS 
module. 



ALARMS 
Priority 6 



O 



SCAN, 
Priority 4 



r 



© 

u 
© 

O 
O 



\- 




SCAN3 subroutine needed by both 
SCAN and ALARMS modules - - 
One copy in each module. 

SCAN4 subroutine also needed by both 
SCAN and ALARMS modules. It is core 
resident and reentrant. 
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11.5.5 Externals to Mass Memory Programs 

Externals in mass memory programs which reference locations which are core 
resident must be absolute. Externals which reference addresses in other mass 
memory programs (in the same module) must be relative. There must not be any 
externals which reference addresses in any other module. This is because one 
module does not know when another module is in core (or where it is) unless special 
links are provided to handle it/ This means that any subroutine which several 
modules need would be either core resident or there would be a separate copy in 
each module that needs it. Another solution would be to put the subroutine in a 
separate module by itself and let routines needing it schedule it. 



11. 5. 6 Space 



Mass memory programs may release their own space. This is a good feature 
because it means that a program can schedule a mass memory program and then 
can forget about it after the schedule request has been accepted and exit knowing 
that the scheduled program will be executed at its priority. The mass memory 
program could pick up the address of where it is, as its first instruction (i.e.), 
and store it in the release request which would be the last instruction in the pro- 
gram. 



1. 




NAM 


2. 


SCNMSG 


NUM 




REL 


STA* 

r 

RTJ- 


3. 




NUM 
NUM 
END 



SCNMSG 

$C8FE 

REL+2 

($F4) 
$1801 




LDA* *-l 



RELEASE REQ., TBIT SET 
ADDRESS TO BE RELEASED 



core during execution: 



FWA 



FWA 



C8FE 



68xx 



54F4 



1801 



FWA 



~\ 



> 



Space gotten in SPACE 
request 



J 
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1. Note that SCNMSG is not declared as an entry point since it is also the name 
of the module. 

2. Remember that the first word preceding Space in allocatable core obtained by 
a SPACE request contains the address of where that block of space is. The 
NUM $C8FE is to fake out the assembler and cause it to make a code as the 
first word of the program which will be a LDA* *-l. A LDA* *-l instruction 
would not have been assembled properly because it attempts to reference out- 
side of the program area relatively. Also remember that the first word of a 
mass memory module is executed so the NUM will not be treated as data. So, 
the $C8FE gets the address of the space occupied by the program into A. 

3. Note that in the release request the T t' bit (bit in the first word of the pa- 
rameter string) is set to indicate to the system not to return to the program 
which made the release request after releasing the space. This bit would be 
necessary for a mass memory program releasing its own core. It makes 
sense because if control was returned to the program, there isn't any program 
after the end. Or, even if there was some more program (such as a jump to 
the dispatcher), it may not be executed. Remember that when a release 
request is made, the space is allocated to any waiting requests before the 
return to the requestor. Therefore, the space may have been given away and 
may in fact contain another program or data; a return to the releasing program 
would cause a mess because it may not be there any more. 

If the mass memory module contains several subroutines, the NUM $C8FE 
would be the first instruction in the module and the RELEASE would be the 
last request made in the module. 

Mass memory programs should complete their I/O and their calls to any 
subroutines before exiting. This is because when they release their space 
and exit, any data buffers or completion addresses in the program may be 
lost as soon as the release request is made. 

11.5.7 Mass Memory Problem, MMPGM 

The following example program contains one error which could cause incorrect 
results. It is very subtle and difficult to locate. 

Assume that the assembly- language coding is runanywhere and correct. Look for 
an error which can occur during execution. The program runs at priority 4. The 
driver runs at priority 10. The completion routine runs at priority 6. 
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OOFA 



* 
ADISP 



NAM MMPGM 

ENT MMPGM 

EXT* REQREJ, IOERR 

EXT CORSUB 

EXT SYSPGM 

EQU ADISP($FA) 



MASS MEM PGM EXAMPLE 

MM EXTS IN SAME MODULE RELATIVE 
CORE RES SUB EXT ABSOLUTE 
SYS DIR PGMS MUST BE EXTERNAL 



P00OO C8FE 



MMPGM 



NUM 
STA* 
JMP* 



$C8FE 
REL+2 
WRITE 



FIRST INSTR OF MM PGM EXECUTABLE 
PICK UP CORE ADDRESS OF MMPGM 



P0003 
P0004 
P0005 
P0006 
P0007 
P0008 
P0009 
P000A 
P000B 
P000C 



4D41 
5353 
204D 
454D 
4F52 
5920 
4558 
414D 
504C 
4520 



MSGBUF 



ALF 



*,MASS MEMORY EXAMPLE* 



P000D 
P000E 
P000F 
P0010 
POOH 
P0012 
P0013 
POOH 
P0015 
P0016 
P0017 
P0018 
P0019 



54F4 

0D56 

000F 

0000 

18FC 

000A 

7FF4 

0162 

5800 X 

7FFF X 

5400 X 

7FFF X 

UFA 



P001A 54F4 
P001B 1204 
P001C FFFF X 

P001D 0162 
P001E 5800 X 
P001F 7FFF 



P0020 54F4 
P0021 1801 
P0022 0000 



* 
WRITE 



FWRITE $FC, WROTE-*+l, MSGBUF-*+5, 10, A, 5, 6, 1, X 



REQOK 



SQP 
RTJ 

RTJ+ 

JMP- 
SCHDLE 



REQOK PROT PGMS MUST CHECK REQ ACC 

REQREJ GO HANDLE REJ;REL ADDRESSING 

CORSUB ABS ADDRESSING TO CORE RES PGM 

(ADISP) NO MORE TO DO 

(SYSPGM), 4, SCH SYS DIR PGM, CORE OR MM 



WROTE 



* 
REL 



SQP REL 

RTJ IOERR 



RELEAS 0, T, 



CHECK Q FOR IO ERRORS 
GO ANALYZE ERRORS 



WILL BE REPLACED W/ADDRESS 



DO NOT RETURN TO PGM AFTER REL 



END 



MMPGM 



Map 

I 

REQOK 

IOERR 



00FF MMPGM 0000P ADISP 
0017P WROTE 001DP REL 
001FX REQREJ 0016X 



OOFA MSGBUF 
0020P SYSPGM 



0003P WRITE 000DP 
001CX CORSUB 0018X 



C 
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The following is a description of the concepts presented in MMPGM. Note that an 
entry point MMPGM is declared; therefore, the name of the module must be some- 
thing other than MMPGM. There are two relative externals, REQREJand IOERR, 
which must be subroutines in this same module. There is one absolute external, 
CORSUB, which must be a core resident subroutine. 

P0000 - picks up the address of the core block MMPGM is located in, then 
stores it in the release request. 

P000D - initiates an F WRITE from MSGBUF. RP=5 and CP=6. The X bit is 
set so WROTE-*+l and MSGBUF-*+5 calculate the correct distances 
from POQOE to the completion address WROTE and the buffer MSGBUF 



and places them in P000F and P0013. 



000E 
+000F 
00 ID WROTE 



000E 
+7FF4 

8002 
1_ 

0003 MSGBUF 



o 



P0014 - checks to see if the request was accepted. 

P0017 - jumps to execute CORSUB at running priority 4. 

P0019 - schedules a program in the system directory, SYSPGM, to be executed 
at priority 4 af te r completion of MMPGM. Note that SYSPGM must 
be named external and that the ( ) causes bit 15 to be setinPOOlB. The 
program should have checked Q to see if the request was accepted. 

P001C - the program has now run out of things to do, so it goes to the dis- 
patcher to await the write completion. 

P001D - after the write, the completion routine (running at priority 6) checks 
for errors. 

P0020 - the completion routine then releases core. The T bit is set so that 
after core is released, control will go to the dispatcher instead of 
returning to the program. 



O 



11.6 EXTERNAL REFERENCES AND LINKAGE, SUMMARY 

It is desirable at this point to review the rules regarding externals among the various 
types of system programs. 

Core resident programs can make references to other core resident programs either 
relatively or absolutely. Since there is a choice, it is probably best to use absolute 
mode. Then if this program is ever made mass memory res id en t, its references to 
low core programs will be correct. 
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Core resident programs would not make any references to mass memory programs by 
way of externals. They would schedule the mass memory programs (which would be in 
the system directory). 

Mass memory programs are grouped together in modules. A module may be composed 
of a single program or several programs. Externals which reference core resident 
programs must be absolute. Externals which reference other programs in the same 
module must be relative. Mass memory programs may not reference any programs in 
another module by externals (they can schedule them in). 

A module has a name unique to it which is not an entry point anywhere in the system. 
This is the name in the system directory. Core resident programs can also be in the 
directory but only a few usually are. Any program which may at some later date be 
changed from core resident to mass memory resident (or vice versa) should be in the 
directory so that it can be scheduled by the system directory schedule r eque st form. 
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Figure 28. 1700 Core Map 



r 



Unprotected < 



Program Library 




(*YM) 



system common 



Loader 



Subprogram B 



Subprogram A 



Data Block 



Job Processor 



Request Processor 

System and Process 
Programs 
(*L) 



C ommunications 
Region 



Common 



O 
O 



^2 
•+J 

o 
o 



do not have to be 
run anywhere 

cannot reference any 
locations in a mass 
memory module by 
externals 



(*YM) 

- run anywhere 

- mass memory externals 

relative 0000- _ 

- locore externals absolute 

- cannot reference any locations in 
other mass memory modules by 
way of externals 

Each "group" of mass memory programs loaded and linked together by one *YM control 
statement is called a mass memory module and has a name unique to the module. 
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12. 1 1721 PAPER TAPE READER 

The paper tape reader transcribes data to the lower 8 bits of the A Register at a rate 
of 350 {eight-bit characters per second. The time between frames is 2. 857 milliseconds. 
These times qualify the 1721 to be grouped with the low speed package; equipment num- 
ber 1, station number 2. 

The Q Register will be in the following format when referencing the paper tape reader. 



O 





15 14 13 12 11 


10 9 8 7 


6 5 4 3 


2 


1 







Q 




1 


10 
















v j 


v ^ ' 

Station 2 






^ 






-*- 

Equipment 1 


Director 








-► Data 








1 -+■ Status/Function 


The Q Register will contain either $00A0 or $00A1. 








LDQ =N$00A0 DATA 






LDQ =N$00A1 FUNCTION/STATUS 


12.1. 


1 PTR Functions 















The D portion dictates the operation to be performed in conjunction with the INP 
and OUT instructions. 

D = 1 FUNCTION (OUT) 

The programmer may issue the functions together with the exception of the clear 
controller and clear interrupt functions which must be issued separately. 







A 



1 \ 



Clear Controller 
Clear Interrupts 



o 



LDQ 


=N$00A1 


PTR for FUNC 


ENA 


3 


CLR INT, CLR CONT 


OUT 


-1 
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The remaining functions may be issued jointly. 

15 6 5 4 3 2 1 

A 



Stop Motion 



ion I 



♦ 



Data Interrupt Request 
Select Interrupt on Alarm 
Start Motion 



Data Interrupt - 

Bit 2 allows the programmer to instruct the 1721 to interrupt the 1700 when the 
holding register on the 1721 contains a frame of data ready for transfer. 

Alarm Interrupt - 

Bit 4 permits the paper tape reader to interrupt the computer if one of the following 
conditions arise: 

a) Paper Motion failure 

b) Lost data 

c) Power off 

Start Motion - 

Bit 5 starts the paper tape reader moving tape through the read station. Paper 
will continue to be moved through the read station until the motion is stopped or 
the reader runs out of paper. 

Stop Motion - 

Bit 6 stops the movement of the paper through the read station. The brakes on the 
1721 assure stopping before reaching the next frame. 

PTR for FUNC 

PLACE FUNCTION IN A 

INITIATE DESIRED OPERATIONS 

The logic has been set up, therefore, the programmer needs only to bring the 
data into the computer. 



LDQ 


=N$00A1 


LDA 


=NFUNC 


NOP 




OUT 


-1 



D = DATA 






LDQ 


=N$00A0 


PTR FOR DATA 


NOP 






INF 


-1 


DATA IN LOW 8 BITS OF A 
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12.1.2 PTR Status 



The programmer may monitor the operations of the paper tape reader by taking 
status. 



D = 1 STATUS (INP) 

LDQ =N$00A1 

NOP 

INP -1 



PTR FOR STATUS 
STATUS IN A 



The status bits are in the A Register. 

15 11 10 9 8 7 6 5 4 3 2 10 

A 



Power On 

Paper Motion Failure 

Existence Code 

Protected 

Lost Data 

Alarm 



M t t t t It t B 

— I I Busy 



Ready 



Interrupt 
Data 
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Ready (Bit 0): Power is on and paper tape has been loaded into the reader. 
The preparations have been made known to the logic by pressing the READY switch 
on the paper tape reader console. The reader becomes Not Ready if a paper motion 
failure occurs or if the power is turned off. 

Busy (Bit 1): The paper tape reader is Busy if a Start Motion command has 
been issued and no Stop Motion command has followed. Motion stops on a Stop 
Motion command, a paper motion failure, or if the power is turned off. 

Interrupt (Bit 2): An interrupt condition exists. Other status bits must be ex- 
amined to determine the condition causing this interrupt. 

Data (Bit 3): The Data Hold register in the paper tape reader contains an 8-bit 
frame of data which is ready for transfer to the computer. Start Motion must be 
set to receive this status. The status drops when the Data Hold register is emp- 
tied by transfer to the computer. 

Alarm (Bit 5): At least one of the following conditions exists in the paper tape 
reader: (1) paper motion failure (bit A9), (2) lost data (bitA6), or (3) power off 
(bit A10 is '0'). 

Lost Data (Bit 6) : When in interrupt on Data mode, paper motion continues after 
the Data Hold register is full. If the data is not transferred to the computer before 
the next frame appears, a lost data status occurs to show aframe has been passed. 
The time between frames is 2.857 milliseconds. The status drops when a clear 
controller command is sent. Lost data stops tape motion. 
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Protected (Bit 7) : The PROGRAM PROTECT switch is on. This switch on the 
paper tape reader works in conjunction with the PROGRAM PROTECT switch on 
the computer. If the switch on the computer is off and the PROGRAM PROTECT 
switch of the peripheral device is on, no action is taken but the status bit is set to 
indicate the switch is on. If the switch on the computer is set, all rules of pro- 
gram protection apply. The paper tape reader in this condition only accepts pro- 
tected instructions. 

Existence Code (Bit 8); The paper tape reader is attached. If the bit is a f l', the 
reader is missing from the particular computer system. 

Paper Motion Failure (Bit 9)j__No change in the feed hole circuit has occurred 
for 40 milliseconds while trying to read. The paper motion failure causes the 
reader to become Not Ready; it can only be made ready by pushing the READY 
switch or by a Clear Controller command. It is considered an illegal operation to 
send any other function code to the reader or a read command until the READY 
switch has been pressed or a Clear Controller has been issued. 

JPqwer On (Bit 10): Power to the reader is on. If this bit is a '0', power is off. 
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12.1.3 Example 

The following is a test program for the 1721 paper tape reader. It inputs data, 
beginning with the first nonzero frame, until a zero word is encountered, at which 
time data input stops. The data is stored in the consecutive locations beginning 
after the end of the program. 

The controller should be cleared from the console before the program begins, as 
the clear controller function cannot be sent with the start motion function at line 4. 
The stop switch should be set so the program will stop after reading the tape. 
After it stops, if the switch is set to RUN, the tape which was just read will exe- 
cute (assuming it contained an absolutized program). 



*CLEAR CONTROLLER FROM CONSOLE 
LER IN SAME FUNCTION 



1721 PTR - AUG '68 
USDA 

CANNOT START MOTION & CLEAR CONTROL- 



The following is a test routine for the 1711 teletype. It outputs an 11-word mes- 
sage from the buffer GET. The controller is cleared in a separate function before 
anew function is selected. Write mode is selected because Read mode is in 
effect after the clear controller function. 



O 



00 1 



NAM 



BOOTSTRAP 



0002 

oorn 



PflOOO £000 START 



ENT 
LDO 



START 
=NT>A1 



OOOfr 



P0001 

pnon? 



00A1 
0A20 



FNA 



■fi?n 



0005 
0006 



P0003 
P0004 



03FE 
ODFE 



OUT 

IMP 



-1 



0007 
000R 



P0005 
PQ006 



0B00 
02FE 



LOAD! 



NOP 

IMP 



_=!. 



0009 
0010 



P0007 
P0008 



0113 

IflFD 



SAN 
JMP* 



3 

L0AD1 



0011 
0012 



P0009 
P000 A 



0B00 
02FE 



L0AD 2 



NOP 



-=±- 



0013 
OOl fr 



P000B 
P000C 



0FC8 
0B00 



ALS 
-NOR- 



0015 
0016 



P000D 
P000E 



02FE 



INP 
STAtt 



PTR DIR FUNC 



START MOTTON 



SET TO READ 



TNPUT TRADER 



INPUT FRAME 



SHIFT TO PACK 



-1 

(ADORES) 



INPUT NEXT FRAME 
STORE WORD 



0017 
0018 



P000F 
POQin 



0103 

pa 2 



SAZ 
RAO* 



EXIT-*-l 
ADDRES 



0019 
0020 



P0011 
P0012 



18F8 

QQlfr P ADDRES 



JMP* 
ADC 



LOAD2 
» + 2 



EXIT ON ZERO WORD 
UPDATE ADDItEBS 



0021 
0022 



GO GET NEXT WORD 
LOAD AT P0011 



P0013 0000 



EXIT 



NUM 
-END- 



$0 
START 



ZERO FOR SLS 



-I Q-OF-£ START noOQP L0AD1 OOOtSP LOAD? OOOAP AnDRFS nm?P 

EXIT 0013P 



o 



BOOTST 



1725 



where bootstrap loaded. 
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12.2 1723 PAPER TAPE PUNCH 

The punch is grouped with Control Data's low speed package. The punch is a character 
device. It accepts the lower 8 bits of the A Register as data. These 8 bits may be ASCII 
codes or binary. 

The punch is addressed as Equipment 1, Station 4. 

15 11 10 9876543210 



ivivi'ivivivivXviv/iviviv/ 


1 


10 











Equipment 1 Station 4 



Director 
0-*-Data 
1 -*• Function/ Status 



LDQ 
LDQ 

12. 2. 1 PTP Functions 



=N$00C0 
=N$00C1 



PTP, DATA 

PTP, FUNC/STATUS 



The programmer may direct the operations and interrupt selections of the Punch 
via the Director function. The clear interrupt and clear controller function may 
be issued together but should not be issued with the other functions. 



15 









| 








| CLR Controller 
CLR INT 


LDQ 

ENA 
OUT 


=N$00C1 

3 

-1 


PTP, FUNC 


-« 





The remaining functions may be issued together. 

15 6543210 



A mMMMM 



Stop T T J Data Interrupt 

Motion-' I Alarm Interrupt 
Start Motion 



LDQ 


=N$00C1 


PTP, FUNC 


LDA 


=NFUNC 


FUNCTIONS 


OUT 


-1 


INITIATE FUNCTIONS 
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12.2.2 PTP Status 

The programmer may status the Paper Tape Punch by setting the Director bit to 
a '1' and issuing an INP instruction. 

=N$00C1 PTP, STATUS 

STATUS TO A 
576543210 



15 



LDQ 






=N 


NOP 








INP 






-1 


12 


11 


10 


9 



A 



Tape Supply Low — 
Power On 



A A 4 4 4 



Tape Break 

Existence Code - 
Protected 



Alarm 



A * 



J Ready 
Busy 
Interrupt 



Data 



O 



Ready (Bit 0): The paper tape punch is Ready when its power is on, tape has been 
loaded, and the READY switch on the station console has been pressed. The 
punch becomes NOT READY if tape break occurs or if power is turned off. 

Busy (Bit 1): The punch is Busy if a Start Motion is in effect or until the punch 
has finished processing the data in the Data Hold register. 

Interrupt (Bit 2) : An interrupt condition exists. Other bits can be monitored to 
determine if one or more of the selected interrupts has occurred. 

Data (Bit 3): The 8 bits of data in the Data Hold register of the punch have been 
punched and the new data may be received from the computer. The data status 
drops when a transfer from the computer is made. 

Alarm (Bit 5): This status indicates that one of the following conditions has arisen: 

a. Tape Break 

b. Power off 

c. Tape low 

The status drops when the condition is corrected. 

Protected (Bit 7) ; The PROGRAM PROTECT switch on the peripheral equipment 
is set. The status bit only indicates that the switch is set; it does not show if a 
program protect violation occurred. If the PROGRAM PROTECT switch on the 
computer is on, the punch does not accept commands which are not protected. All 
rules of program protection apply. 
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Existence Code (Bit 8): A zero setting acknowledges that the paper tape punch is 
attached. If the bit is a '1', the punch is missing from the particular computer 
system. 

Tape Break (Bit 9): The tape break status bit is set if the punch supply tape has 
broken or run out and approximately 2 inches of tape remain. - If the tape supply 
low bit is ignored, it results eventually in the Tape Break condition as the supply 
of tape is exhausted. The Tape Break condition causes the punch to become Not 
Ready. It can only be made Ready by loading paper tape and pressing the READY 
switch. However, it is still able to receive the Clear Controller and Clear Inter- 
rupts function codes so that the Interrupt signal (if Interrupt on Alarm was selected) 
can be dropped. It is considered an illegal operation to send any other function 
code or a Write signal until the READY switch has been pressed. 

Power On (Bit 10): The power to the punch is on. If this bit is not a '1', the 
power is off and an Alarm interrupt may be generated. 

Tape Supply Low (Bit 11): The available supply of tape remaining to be punched is 
limited. 



V 
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12.2.3 PTP Example Program 



12.2.3 



O 



0001 






0002 






0003 


P0000 


0019 


0004 




00 1A P 


0005 




OOEA 


0006 




00C1 


0007 






0008 


P0019 


0002 


0009 


P0018 


0001 


0010 


P001C 


COOO 




P001D 


0000 P 


0011 


POO IE 


9000 




POO IF 


001 A P 


0012 


P0020 


0113 


0013 


P0021 


1400 X 




P9022 


7FFF X 


0014 


P0023 


OBOO 


0015 


P0024 


68F5 


0016 


P0025 


0864 


0017 


P0026 


68F2 


0018 


P0027 


COOO 




P0028 


7FCD 


0019 


P0029 


60FF 


0020 


P002A E000 




P002B 


00C1 


0021 


P002C 


0A01 


0022 


P002D 


03 FE 


0023 


P002E 


0A20 


0024 


P002F 


03FE 


0025 


P0030 


ODFE 


0026 


P0031 


0844 


0027 


P0032 


03FE 


0028 


P0033 


DOFF 


0029 


P0034 


01A1 


0030 


P0035 


18FC 


0031 


P0036 


C8E3 


0032 


P0037 


0FC8 


0033 


P0038 


OBOO 


0034 


P0039 


03FE 


0035 


P003A 


0FC8 


0036 


P003B 


OBOO 


0037 


P003C 


03FE 


0038 


P003D 


0844 


0039 


P003E 


60FF 


0040 


P003F 


C500 




P0040 


0000 P 


0041 


P0041 


88D9 


0042 


P0042 


68D8 



START 



NAM 


PUNCH 




ENT 


START 




.BZS 
EQU 


A A /o e\ M 


CPT "RTTTrTTF"R Tfl "|K% 


BB(AA+25)-*^^ 


FROM CONSOLE 


EQU 


ADISP($FA) 


---NOTE THAT 26 WORDS WILL 


EQU 


PUNCH ($00C1) 


BE OUTPUT, NOT 25 


EXT 


ERROR, DISP 




BSS 


TEMP (2) 


RESERVED FOR BLOCK SIZE 


BZS 


CKS(l) 




LDA 


=XAA 


FWA 


SUB 


=XBB 


LWA 



OK 



LOOP1 



NEXT 



LOOP2 



SAN 


OK-*-l 


JMP+ 


ERROR 


NOP 




STA* 


TEMP+1 


TCA 


A 


STA* 


TEMP 


LDA 


=X$7FFF-50 


STA- 


I 


LDQ 


=XPUNCH 


ENA 


+1 


OUT 


-1 


ENA 


$20 


OUT 


-1 


INQ 


-1 


CLR 


A 


OUT 


-1 


RAO- 


I 


SOV 


NEXT-*-l 


JMP* 


LOOP1 


LDA* 


TEMP+1 


ALS 


8 


NOP 




OUT 


-1 


ALS 


8 


NOP 




OUT 


-1 


CLR 


A 


STA- 


I 


LDA+ 


AA,I 


[ADD* 


CKS 


(.STA* 


CKS 



IF UNEQUAL, ALL IS FINE 
CONTAINS SIZE OF BLOCK 



BLOCK SIZE COMPL 
COMPLEMENT BLOCK SIZE 
BLOCK SIZE A 



I EQUALS COUNTER FOR LEADER 
PREPARE PUNCH TO RECEIV 

CLEAR CONTROLLER 



PREPARE PUNCH FOR DATA 

JUMP ON SELF UNTIL OUT 
UPDATE LEADER COUNT 

WHEN 1=8000, 50 BLANKS 
KEEP OUTPUTTING BLANK L 
COMPLEMENT OF BLOCK SIZE- 
HIGH ORDER BITS PUNCHED FIRST 



LOW ORDER BITS SECOND 

SIZE OF BLOCK NOW ON TAPE 

ZERO OUT THE INDEX I 

PLACE FIRST WORD OF DATA IN 

CHECKSUM 



o 
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0043 


P0043 


C500 




LDA+ 


AA,I 




P0044 


0000 P 








0044 


P0045 


0FC8 




ALS 8 




0045 


P0046 


0B00 




NOP 




0046 


P0047 


03FE 




OUT 


-1 


0047 


P0048 


0FC8 




ALS 


8 


0048 


P0049 


0800 


Could 


NOP 




0049 


P004A 


03FE 


compute 


OUT 


-1 


0050 


P004B 


DOFF 


CKSUM 


*RAO- 


I 


0051 


P004C 


COFF 


here 


LDA- 


I 


0052 


P004D 


98CB 




SUB* 


TEMP 


0053 


P004E 


0101 




SAZ 


SUM-*-l 


0054 


P004F 


18EF 




JMP* 


LOOP2 


0055 


P0050 


C8CA 


SUM 


LDA* 


CKS 


0056 


P0051 


0FC8 




ALS 


8 


0057 


P0052 


OBOO 




NOP 




0058 


P0053 


03FE 




OUT 


-1 


0059 


P0054 


0FC8 




ALS 


8 


0060 


P0055 


OBOO 




NOP 




0061 


P0056 


03FE 


sov — 


*OUT 


-1 


0062 


P0057 
P0058 


COOO 
7FCD 




LDA 


=X$7FFF-50 


0063 


P0059 


60FF 




STA- 


I 


0064 


P005A 


0844 




CLR 


A 


0065 


P005B 


68BF 




STA* 


CKS 


0066 


P005C 


03 FE 


LOOP3 


OUT 


-1 


0067 


P005D 


DOFF 




RAO- 


I 


0068 


P005E 


01A1 




SOV 


DONE-*-l 


0069 


P005F 


18FC 




JMP* 


LOOP3 


0070 


P0060 


0D01 


DONE 


INQ 


1 


0071 


P0061 


0A01 




ENA 


1 


0072 


P0062 


03FE 




OUT 


-1 


0073 


P0063 
P0064 


COOO 
C040 




LDA 


=N$40 


0074 


P0065 


03FE 




OUT 


-1 


0075 


P0066 


14EA 




JMP- 


(ADISP) 


0076 








END 


START 



ORIGINAL DATA IN A 



OUTPUT FIRST CH. 



OUTPUT SECOND CH. 
UPDATE INDEX 
PLACE UPDATE IN A 

BLOCK IS PUNCHED 



FIRST CH. OUT 



CHECKSUM ON PAPER TAPE 
PREPARE FOR END LEAD 

INITIALIZE INDEX I 



OUTPUT BLANK LEADER 
UPDATE INDEX 

IF OVERFLOW FINISHED 

PREPARE PTP FOR FUNCTION 

CLEAR CONTROLLER 
STOP MOTION 

OUTPUT FUNCTION 



I 00FF START 001CP AA 

PUNCH 00C1 TEMP 0019P CKS 

NEXT 0036P LOOP2 003FP SUM 

7FFFX ERROR 0022X 



DISP 



0000P 


BB 


001AP ADISP 


00EA 


00 IBP 


OK 


0024P LOOP1 


0032P 


0050P 


LOOP3 


005CP DONE 


0060P 



littltlW«**««***t«tWI»M->tll4S*tSlliltSltllli1ii*l 



•:• O.rxil • • • • * li » * •••»••# 




»••••••••*»»»«*»•«•»»« 



•rrrir« •••••••• ••••••• 



— ..iitt* 



""" 



DATA: 26 WORDS 



CHECKSUM ' 

t 

SUM OF ALL DATA WORDS, DISREGARDING OVERFLOW 



L WORD 
COUNT 
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12.3 1711 TELETYPEWRITER 

The 1711 Teletype may send and receive information. The data transmission to or 
from the 1711 takes 100 milliseconds. 

The Teletype is one of three devices composing the low speed package which is always 
Equipment Number 1. All interrupts generated by the teletype shall be processed via 
line 1 interrupts. 

TheQ Register will contain $0091 or $0090 when communicating with the teletype. Break 
this word down into Binary, and we have Equipment 1, Station 1. 



O 



o 



w 



E 



Q 



s 











D 



Equipment 1 



Station 1 Data 

Function or Status 1 



The D portion denotes the transfer of data when set to zero. All data transmissions will 
be to and from the lower 8 bits of the A Register. The characters will be transferred 
in ASCII codes, one character at a time. The directional flow of the data will be governed 
by the INP and OUT instructions. 

TTY FOR DATA 

READ DATA INTO A 

TTY FOR DATA 
PUT DATA IN A 

WRITE DATA ON TTY 

12. 3. 1 TTY Functions 

The D portion indicates a function or a status when set to a 1. A function is indi- 
cated by issuing an OUT instruction with A preset to the function. 

TTY FOR FUNC OR STATUS 
PLACE FUNCTION IN A 



LDQ 


=N$0090 


NOP 




INP 


-1 


LDQ 


=N$0090 


LDA 


BUF 


NOP 




OUT 


-1 



LDQ 


=N$0091 


LDA 


FUNC 


NOP 




OUT 


-1 



OUTPUT A FUNCTION 







A 



| CLR CONT 
CLR INT 

The clear controller and clear interrupt functions must be sent to the teletype 
prior to selecting other functions. 
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15 


10 


9 


8 


7 


5 


4 


3 


2 


1 









1 lllllfll 













Select Read Mode^ t 
Select Write Mode I 

Select Interrupt on Alarm 

Select Interrupts on End of Transmission 

(EOT Key) 



f ^Clear Controller 
Clear Interrupts 
Data Interrupt Request 



The 1711 provides the capability of selecting three interrupts; DATA, ALARM, 
and END OF TRANSMISSION (EOT). The DATA interrupt will occur when the 
teletype is prepared to send or receive data. The ALARM interrupt will be 
generated if data has been lost or if the teletype goes from RE ADY to NOT READY. 
The END OF TRANSMISSION interrupt will occur whenever the EOT key on the 
console of the teletype has been pressed. None of these conditions will generate 
an interrupt unless the programmer has selected them. 

The motor will be started on the 1711 by an output of a dummy character - to the 
teletype. 

12. 3. 2 TTY Status 

Status will be sent to the A Register from the teletype with an INP instruction. 

=N$0091 TTY FOR STATUS OR FUNC 



LDQ 
NOP 

INP 



-1 



INPUT STATUS TO A 



The A Register will contain the status and the programmer may examine it to 
determine the next procedure he wishes to follow. 



15 



12 11 10 9 



5 4 










Manual Interrupt 
Motor On 



t t 



Read Mode — I 



k k A k k A * 

I Ready 

Busy 

Interrupt 

Lost Data - 1 Data 

Alarm ' End of Transmission 



Ready (A0 is 1): If this bit is set in the A Register, the Power switch on the con- 
sole of the teletypewriter is in the ON-LINE position and the motor is on. 

Busy (Al is 1); If this bit is set, one or more of the following conditions exist: 

a) The controller is in Read mode and is in the process of receiving a char- 
acter from the teletypewriter or the Data Hold register contains data for 
transfer to the computer. The Busy status drops upon completion of the 
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transfer to the computer if data has not been lost. If data has been lost, 
the controller requires 200 milliseconds to stop the teletypewriter and 
remains Busy all this time. 

b) Write mode and the Data Hold register contains data and is in the process 
of transferring it to the teletypewriter. Busy drops upon completion of the 
transfer. 

c) Either mode and the controller is in the process of starting the motor in 
the teletypewriter. In Write mode output of a character starts the motor 
and this character is lost. In Read mode, the BREAK key must be pressed 
to start the motor. 

Interrupt (A2 is 1): An interrupt condition exists. Other bits must be monitored 
to determine the condition causing this interrupt. 

Data (A3 is 1) : An interrupt is generated and this status bit is a 1 under the fol- 
lowing conditions: 

a) Read mode and the Data Hold register contains data for transfer to the 
computer. The status drops upon completion of a Read. 

b) Write mode and the controller is ready to accept another Write from the 
computer. The status drops upon completion of the Write. 

End of Transmission (A4 is 1): The Data Hold register contains the End of Trans- 
mission code. This code is generated by pressing the EOT key on the keyboard 
of the teletypewriter. The end of transmission status drops upon the completion 
of the next Write or Read. 

Alarm (A5 is 1) : The teletypewriter is not in a Ready state or has lost data. 

Lost Data (A6 is 1) : The controller was not serviced by the computer before a 
new character was sent by the teletypewriter. The keyboard and tape transmitter 
are locked out. The status bit indicates a Lost Data condition, and a Busy status 
indicates that the process of stopping the teletypewriter is in progress. Data held 
in the Data Hold register is not disturbed, but the incoming data is ignored. The 
lost data status can be cleared by a Clear Controller or a Select Write Mode com- 
mand. These two functions are rejected while the controller is stopping the tele- 
typewriter. The Select Write mode command must be preceded by a Read operation 
to clear the Data Hold register. After the teletypewriter has stopped, the computer 
may do an Output operation to notify the controller of the Error condition. 

Read Mode (A9 is 1): If this bit is a 1, the controller is conditioned for an Input 
operation from the teletypewriter. Read mode is automatically in effect after a 
clear controller function has been issued. 
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Motor On (A10 is 1): The motor of the teletypewriter is on. The presence of this 
bit indicates that the teletypewriter motor is on and up to speed. 

a) Write mode: Motor starts with the output of a character. Two-second 
delay occurs between output of the character and this status bit being set 
to allow the motor to get up to speed. 

b) Read mode: Press the BREAK key to turn on the motor. Two-second 
delay. also occurs between the action of the BREAK key and the status bit 
being set to allow the motor to get up to speed. 

Manual Interrupt (All is 1): The manual interrupt button on the teletype has been 
pressed. 

Example: 

The following is a test routine for the 1711 teletype. It outputs an 11-word mes- 
sage from the buffer GET. The controller is cleared in a separate function 
before a new function is selected. Write mode is selected because Read mode 
is in effect after the clear controller function. 
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12. 3. 3 TTY Example Program 
-&044 NAM TYPE QUT - 



0002 P0000 504C GET ALF 11»PLEASE INPUT YOUR CODE 

P0Q01 45 4 1 ^ 

POO 02 5345 Message 
P0003 2049 ■ 



POO 04 4E50 
P0005 5bb 4 



P0006 20b9 
P0 00 7 4Fb5 



P0008 5220 
POO 09 '+34F 



o 



c 



POOOA <f445 
0003 POQOB 0844 C-k-R- 



0004 POOOC 60FF STA- I 

0005 P000P E000 L-OlQ =N $0 091 T TY DIR FUNC 

P000E 0091 

0006 POQOF 0A03 EHA %3 CT.R CiONTR ft TNT 

0007 P0010 03FE OUT -1 

00 8 POO U CO UM =N$10 -Q WRITE MODE 

POO 12 0100 

0009 P0013 0t300 WOP 

0010 P0014 03FE OUT -1 

0011 POOlb 0DFE Um =4 WRI T E - DATA FUNC 

0012 P0016 0B00 NOP 

001 3 P0017 3 KE OUT =0 SEND DUMMY CHAR 

0014 P0018 C9E7 LOOP LDA* GET* I OUTPUT DATA 

0015 P0019 0FC8 A4r-S 8 

0016 P001 A 80 NOP 

0017 poniR mFE am =J 

0018 P001C 0FC8 ALS 8 

019 POO I D B 00 NOE 

0020 P001E 03FE OUT -1 

021 POO I F DOFF RAO- I 

0022 P0020 C0FF LOA- I 

0023 P0021 09 F 4 IMA ^1J 

0024 P0022 0101 SAZ DONE-*-l 

0025 P0023 18 F 4 JMP» LOOP 

0026 P0024 0000 DONE 

0027 EMO 



4 0FF &&T 0000P LOOP 0018P DONE 002 4P- 
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Typewriter Printout 



PP 

* 

MI 

*K, 15 
J 
*p 

J 

*ASSEM 

L,03 FAILED 01 

ACTION 

CU 

L, 03 FAILED 01 

ACTION 

CU 

L, 03 FAILED 01 

ACTION 

CU 

J 

*p 

J 

*L,8 

J 

PLEASE INPUT YOUR CODE 



Output from program 



USDA - August 1968 
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12.4 1713 TELETYPEWRITER 



The 1713 is composed of a keyboard, printer, paper tape reader, and a paper tape 
punch, each accessible by the computer. The 1713 is grouped with the low speed 
package, equipment number 1, station number 1. The Q Register will be in the following 
format when referencing the 1713. 



Q 



15 






11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 


























1 








1 











- 



Equipment 1 Station 1 



= Data 

1 = Function/Status 



LDQ 
LDQ 



=N$0090 
=N$0091 



SEL TTY, DATA 

SEL TTY, STATUS OR FUNCTION 



The programmer has the option of selecting the reader, punch, printer or keyboard. All 
four units may be used together or separately. The selection is made by setting an 
appropriate bit in the function word. 



A 



15 


14 


13 


12 11 10 











| | 





o 



Bit 14 
Bit 13 
Bit 12 



Bit 11 



Bit 10 



t t t t ♦ 

I Select Keyboard Mode 

Select Keyboard- Tape Mode 

Select Tape Mode 

Select Tape- To- Tape Send Mode 

Select Tape- To- Tape Receive Mode 

Connects the punch to the controller leaving the keyboard and reader inactive. 

Connects the reader only to the controller. 

Connects the page printer and reader to the controller. The keyboard and 
punch are connected together as an off-line tape preparation device. Read 
operations transfer information from the paper tape reader to the controller 
and the page printer. Write operations transfer information to the page 
printer. Simultaneously, a new tape can be prepared from keyboard entries. 

Connects the keyboard, page printer, reader and punch to the controller. A 
character struck on the keyboard or sent from the reader is printed, punched 
and transmitted. A character sent to the 1713 is printed and punched. 

Connects the keyboard and printer to the controller which act as a send/receive 
page printer. The paper tape units are inactive in this mode. 



o 
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12.4 



The 1713 accepts the lower eight bits of the A Register as data and sends eight bits of 
data to the A Register. All codes going to the page printer must be eight bit ASCII 
codes. The data transfer rate is 100 milliseconds per character. 



12.4.1 1713 Functions 

Prior to selecting a mode, the controller and interrupts maybe cleared by issuing 
a function to the 1713. 



15 







A 



t ♦ 

| CLR Controller 

CLR Interrupts 



LDQ 


=N$91 


SEL TTY, FUNCTION 


ENA 


$3 


CLR CONT & CLR INT 


OUT 


-1 





Interrupts may be selected by setting the following bits. 
15 4 3 2 



t t ♦ 

I Data INT Request 

End of Operation Interrupt 

Alarm Interrupt Request 



C 



Bit 2 p- Allows the 1713 to interrupt the computer whenever the holding register 

is ready to send or receive data. 

Bit 3 ► Notifies the 1713 to interrupt the computer whenever an operation is 

completed. 

Bit 4 ► Provides for an interrupt whenever an alarm condition arises. Alarm 

conditions: 

1. 1713 becomes NOT READY 

2. LOST DATA 

3. Out of Tape 



LDQ 


=N$91 


LDA 


=N$1C 


NOP 




OUT 


-1 



SEL TTY, FUNCTION 

INT ON DATA, ALARM, EOF 
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12.4.1 

The operating mode, READ or WRITE, is selected by setting a bit in the function 
word. 

15 9 8 

A 



f t 

| Select Write Mode 

Select Read Mode 



LDQ 


=N$91 


SEL TTY, FUNCTION 


LDQ 


=N$100 


WRITE MODE 


NOP 






OUT 


-1 




LDQ 


=N$91 


SEL TTY, FUNCTION 


LDA 


=N$200 


READ MODE 


NOP 
OUT 


-1 





o 



When running in Tape- To- Tape Send Mode, the program must issue a START 
TAPE MOTION function. When reading data from the reader a start motion function 
must be issued after each character. 



A 



15 




5 













LDQ 
LDA 

NOP 
OUT 



=N$91 
=N$2220 



Start Tape Motion 

SEL TTY, | FUNCTION 

TAPE SEND, READ, START TAPE 

MOTION 



-1 



All of the functions mav be issued together with the exception of the clear con- 
troller and clear interrupt functions which must be issued separately. 



12.4.2 1713 Status 



Status may be taken on the 1713 at any time. 

=N$91 SEL TTY, STATUS 



LDQ 
NOP 
INP 



-1 



STATUS IN A 
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12.4.2 



11 10 


9 




6 


5 


4 


3 


2 10 


|::;:;:;:i:;:;:;:;:;:;:;:;:;:;:;:;:;:;:;:;| | 














1 1 



■J t t 



Manual INT 

Motor On J 
Read Mode J 



t t t t t t ♦ 

I Ready 

| Busy 



Lost Data- 1 



Interrupt 
Data 
End of Operation 
Alarm 



r 



When the corresponding bit is a 1, the condition exists. 
READY ► 



BUSY 



INTERRUPT 
DATA p 



END OF OPERATION 

ALARM ► 

LOST DATA ► 



READ MODE 



MOTOR ON 



MANUAL INTERRUPT 



The 1713 is capable of performing operations and ac- 
cepting functions. 

The 1713 is in the process of performing an operation. 

An interrupt has been generated. 

The holding register in the 1713 is prepared to send or 
receive data. 

The 1713 has completed an operation. 

An alarm condition exists in the 1713. 

The 1713 had data in the holding register which was not 
picked up by the computer before another character was 
read into the register. 

The 1713 is in a read mode. If this bit were not set, 
the write mode would be in effect. 

The 1713 motor is on. If this bit were not set, the 
motor is not on. 

-The manual interrupt button on the 1713 has been 
pressed. 



12.4.3 Example Program, 1713 TTY 

The following program generates 10 frames of data in the A Register and punches 
them on paper tape. It then stops and waits for the tape to be put in the reader. 
It reads 20 frames and stores them in a buffer. Program read can be checked by 
sweeping the buffer. 
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12.4.3 



The STOP Switch should be set before the program is run. 



O 



0001 



NAM 



PT1713 



0002 
0003 



P000Q 00U0 



PT17 1 3 



ENT 
— 0— 



PT1713 
J} 



0004 



P0001 
POO 02 



E000 
Q 9 1 



LDQ 



=N$91 



TTY, FUNC/STATUS 



0005 
0006 



P0003 
P0004 



0A0 3 
03FE 



EN A 



-04J4- 



$3 



CLR CONTR, CLR INT 



0007 
0008 



P0005 
P0006 



02FE 
OFCF 



INP 
A LS 



-1 
-45- 



INP STATUS 
READY BIT 



0009 
0010 



P0007 
POO OR 



0131 
1BFC 



SAM 
JMP* 



1 

«-3 



0011 



P0009 
P000A 



C000 
JU2JL 



LDA 



=N$4120 



SKIP WHEN READY 
GO WAIT TILL READY 



TTR, WRITE, START MOTION 



0012 
0013 



P000B 
P000C 



OB00 
3FE 



NOP 
OUT 



-=1_ 



0014 
0015 



P000D 
P0 00E 



ODFE 
5R41 



INQ 
RT.I< 



-1 

LFAnER 



0016 
017 



P000F 

pnmn 



OAOF 
3FF 



WRITE 



ENA 

out 



$F 



PREPARE TO SEND DATA 
CO OUTPUT LEADER 



DATA $F IN A 
OUTPUT DATA 



0018 
019 



P0011 

pom? 



DOFF 

noo 



RAO- 
L OA 



I 

= N -1 0^T 



10 FRAMES 



0020 



P0013 
PQ014 



FFF5 
0101 



SA7 



0021 
0?? 



P0015 
P0 016 



18F9 
5839 



JMP* 
PT.l» 



WRITE 
I FADFR 



GO OUTPUT TRAILER 



0023 
002 4 



P0017 
POO 18 



0000 
0D01 



STOP 



SLS 
4440- 



025 



P0019 

pom a 



0A01 
3FF 



ENA 
OUT 



1 



PREPARE FOR FUNCTION 



CLEAR CONTROLLER 



0027 
00?R 



P001B 

pooic 



02FE 
OFCF 



INP 
ALS 



-1 
.15_ 



INPUT STATUS 
READY BIT 



0029 
0030 



P001D 
P001F 



0131 
18 F C 



SAM 
■ I M P* 



1 
»-3 



SKIP WHEN READY 

GO WAIT UNTIL READY 



0031 



P001F 

p no ? o 



cooo 

PflOO 



SEL 



LDA 



=N$2000 



TTS MODE 



0032 
0033 



P0021 
P0022 



0B00 
03FF 



NOP 
O UT 



-1 



0034 
0035 



P0023 
P0 Q 24 



0A20 
3FF 



MOTION 



ENA 



$20 
-1 



START MOTION 



0036 
QQ 37 



POO 25 
P00?6 



ODFE 
0B0 



INQ 
NOP 



-1 



PREPARE FOR DATA 



0038 
0039 



P0027 
P Q2 8 



2FE 
011(3 



LDR 



INP 
SA N 



-1 INPUT DATA 

STORF-*-! STORE WHEN DATA COMES 



0040 
0041 



P0029 
P0 2A 



OD01 
1 8F4 



INQ 
JMP » 



1 
SEI 



0042 



P002B 
P002C 



COOO 
?0O0 



READ 



LDA 



=N$2000 



GO WAIT FOR DATA 



TTS MODE 



0043 
0044 



P002D 
P0Q 2E 



0001 
0B00 



INQ 
NOP 



FUNCTION 



0045 
0046 



P002F 
P0 030 



03FE 
0A?0 



OUT 

FNA 



-1 

$20 



START TAPE MOT TON 



0047 
004R 



P0031 
P003? 



03FE 
OOFF 



OUT 
TNO 



-1 
-1 



DATA 



0049 
0050 



P0033 
POO 34 



2FE 
6907 



ST OR E 



INP 
STA* 



-1 

B UF+I 



INPUT DATA 
STORE DATA 
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12.4.3 



0051 P0035 O0FF 



0052 



P0036 
P003 7 



CI 
FFE8 



0053 
005^ 



P0038 
P0039 



101 
18F1 



0055 
0056 



P003A 
P003B 



OOUO 



0057 
0058 



P004F 
P0050 



00 
COOP 



005Q 



P0051 
P0052 



7HCD 
60F.F 



0060 
0061 



P0053 
PQ05 fr 



0844- 
03PE 



0062 
0063 



P0055 
P0056 



DOFF 
1 A 1 



0064 
0065 



P0057 
P0058 



18FC 
60FF 



0066 
0067 



P0059 1CF5 



F1NI 
B U F 



LEADER 



RAO- 



LDA 



SAZ 

JMP* 



SLS 




-k-D-A- 



STA- 



OUTLUR 



CLR 



RAO- 
SOV 



JMP* 
STA- 



JMP* 
END 



=N-20»I 



FINI-*-l 

READ 


BUF(20) 





= X-50 



-i 



A 



OUTLDR 
-4 



20 FRAMES 



STOP AFTER READING 
SWEEP BUFFER TO CHECK 



WRITE LEADER OR TRAILER 



(LEADER) 




Plant 2 - September 1968 



f 
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12.5 1726/405 CARD READER 

The 405 is a Non- Buffered Card Reader capable of reading 1200 80-column cards per 
minute or 1600 51-column cards per minute. The transfer rate for one 80-column card 
is 384 microseconds. 

The twelve rows in each column constitute the 12-bit data word transferred to the com- 
puter. Software packing must be performed in order to form a 16-bit word. The format 
for the columns in relation to memory words is as follows : 



Word 1 
Word 2 
Word 3 

Four card columns represent three computer words, therefore, one 80-column card 
represents 60 memory words. 

The data read by the 405 may be buffered if connected to the 1706. 

The Q Register will be in the following format when referencing the 405 Card Reader. 

15 11 10 7 6 10 

Q 



15 




7 4 


3 


Col 1 (12 rows) 


Col 2 (4 rows) 


Col 2 (8 rows) 


Col 3 (8 rows) 


Col 3 (4 rows) 


Col 4 (12 rows) 



W = 



E 



D 



The E portion will correspond with the setting of the equipment switch on the controller, 
The D portion designates the operation to be performed. 

12. 5. 1 CR Functions 



D = 1 DIRECTOR FUNCTION (OUT) 



LDQ 


=N$0101 


LDA 


=NFUNC 


NOP 




OUT 


-1 



EQUIP 2, FUNC 
FUNCTION IN A 

ESTABLISH LOGIC 



15 14 13 


12 


11 10 


9 


8 


7 


6 


5 


4 


3 


2 


1 









| | 








| | 



A A A A 

Reload Memory | Gate Card 

Negate Hollerith to 
ASCII 
Release Negate Hollerith 
to ASCII 



J CLR Controller 
CLR INT 
Data INT 



EOP INT 
Alarm INT 
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12.5.1 



The functions for the 405 Card Reader may be issued jointly. 

Clear Controller (Bit 0); Directs the clearing of all interrupt requests, motion 
requests, errors, and other logic that may be cleared. This function is sub- 
ordinate to all other functions. 

Clear Interrupts (Bit 1): Clears all interrupt requests and their responses. 

Data Interrupt Request (Bit 2): Sets the interrupt request to be set which causes 
an interrupt to be generated when an information transfer may occur. 

Interrupt on End of O peration (Bit 3): Requests an interrupt to be generated when 
the last card column has been read or a Reload Memory Function has been per- 
formed. 

Interrupt on Alarm (Bit 4) ; Generates an interrupt whenever any of the following 
conditions arise: 

1. Compare or pre-read error 

2. Stacker full or jam 

3. Input tray empty 

4. Fail to feed 

5. Separator card is read into computer memory 

6. Auto/man switch is in man position 

Gate Card (Bit 9): This bit gates the card being read to the secondary stacker. 
This function must be performed during the 1. 5 milliseconds following the input 
of the last column to the buffer memory of the Card Reader. 

Negate Hollerith to ASCII (Bit 10): Whenbit A10 is selected, 7 and 9 punch positions 
in column 1 are ignored and all information (binary or Hollerith) is read as binary. 
Bit A10 is subordinate to bit All. Bit A10 is rejected if the controller is Busy. 

NOTE 

Before beginning a new operation, make certain that bit A10 and the 
following bit, All, are appropriately selected. If this is not done, 
the cards will be read in the mode or state that the card reader was 
in during the previous operation. 

Release Negate Hollerith to ASCII (All = 1): When bit All is selected, the 7 and 9 
punch positions in column 1 determine whether the card information is to be trans- 
ferred in ASCII code or in binary form. The Release Negate Hollerith to ASCII 
function takes precedence over the select Negate Hollerith to ASCII function, and 
it is rejected if the controller is Busy. See Note. 
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12.5.1 

Reload Memory (A12 = 1) : This bit directs the controller to initiate a card feed 
thereby reloading the controller memory with the data from the next card in the 
card reader. The data that has not been transmitted from the memory to the 
computer is lost when Reload Memory is executed. A Reload Memory is required 
only if less than a full card of information is desired. Bit A12 is rejected if the 
controller is Busy. 

12.5.2 CR Status 

D = 1 STATUS (INP) 



LDQ 


=N$0101 


EQUIP 2, STATUS 


NOP 






INP 


-1 


STATUS IN A 



o 



15 


14 


13 


12 


11 


10 


9 


8 


7 6 


5 


4 


3 


2 


1 



















1 E&s 








| | 



ttttttttt t 

I Alarm 

Protected 

Error 

Binary Card 

Separator Card 

Fail to Feed 

Stacker Full of Jam 

Input Tray Empty 

End of File 

Manual Switch or Motor Power Off 



" t t t ♦ 

I Ready 

Busy 

Interrupt 

Data 

EOP 



Ready (Bit 0) : The presence of this bit indicates that the card reader is ready for 
operation. 

Busy (Bit 1): The controller is Busy whenever a card is being entered into the 
buffer memory. 

Interrupt (Bit 2) ; The interrupt status is available if one or more of the selected 
interrupts has occurred. Other bits must be monitored to determine the condition 
causing the interrupt. 

Data (Bit 3): This status bit indicates that data is ready to be transferred to the 
computer. 
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End of Operation (Bit 4) : This status bit indicates that the last card column has 
been read from the buffer memory, or a reload memory function has been sent. 
This bit remains al until a Reply signal is sent, or a Clear Controller function or 
Master Clear is issued. 

Alarm (Bit 5) ; The bit remains a 1 until whatever caused the Alarm condition is 
removed. This status bit indicates that one or more of the following conditions 
has occurred: 

1. Compare or Pre-read error 

2. Stacker full or jam 

3. Input tray empty 

4. Fail to feed 

5. A separator card has been transferred to the computer memory. 

6. The AUTO/MAN switch is in the MAN position 

Status bit A06 is not used. 

Protected (Bit 7) : This status bit indicates that the controller recognizes only the 
I/O instructions that have the protect bit present. This status bit is a 1 when the 
PROTECTED/UNPROTECTED switch is in the PROTECTED position. 

Error (Bit 8): This bit indicates that a Pre-read or Compare error has occurred. 

Binary Card (Bit 9): This bit is present when the contents of the first card column 
have been transferred to the computer memory and a binary card (rows 7 and 9 
punched in first column) was detected, or the Negate Hollerith to ASCII function 
was selected. This bit remains a 1 until a Clear Controller or Master Clear 
function is issued, or a Reply is sent when a card is read under the following 
conditions : 

1. The card is not a binary or a separator card. 

2. The Release Negate Hollerith to ASCII function is selected. 

Separator Card (Bit 10): This bit is present when the contents of the first card 
column have been transferred to computer memory and a separator card (rows 6, 
7, 8, and 9 punched in first column) was detected. This bit remains a 1 until a 
Reply is sent when a card is read that is not a separator card, or until a Master 
Clear or Clear Controller function is executed. 

Fail to Feed (Bit 11): This bit is a 1 if another card is not detected at the primary 
read station 500 ms after the previous card has cleared the secondary read station. 

Stacker Full or Jam (Bit 12) : This bit is a 1 when the stacker is full of cards or 
when the cards have jammed. 

Input Tray Empty (Bit 13) : This bit is a 1 when the input tray is empty. 
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12.5.2 



End of File (Bit 14): This status bit becomes al when the input tray is empty, the 
buffer memory is unloaded, and the END OF FILE switch is on. When the input 
tray does not contain the last card of a file, the switch should be off to inhibit this 
status bit. 

Manual (Bit 15): This status bit is a 1 when the AUTO/MAN switch is in the MAN 
position or the MOTOR POWER switch is off. 



D = DATA (INP) 



A 



15 


LDQ 
NOP 
INP 

12 


11 


=N$0100 EQUIP 2, DATA 
-1 DATA IN A REG 










DATA 



o 



o 



Packing must be performed in order to obtain 16 bit words as indicated earlier in 
this discussion. 
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12.5.3 



12. 5. 3 CR Example Program 



START 
SECOND 



LOOP 



DONE 



NAM 

EQU 

EQU 

BSS 

CLR 

STA- 

LDQ 

LDA 

NOP 

OUT 

INQ 

NOP 

INP 

ALS 

STA* 

INP 

STA* 

ARS 

AND 

ADD* 

STA* 

LDA* 

ALS 

AND 

STA* 

INP 

STA* 

ARS 

AND 

ADD* 

STA+ 

LDA* 

AND 

ALS 

STA* 

INP 

AND 

ADD* 

STA* 

LDA- 

INA 

STA- 

INA 

SAZ 

JMP* 

LDQ 

RAO 

LDA 

SOV 

JMP 

SLS 

END 



CARDRD 

AA($3FF), CARD($0281) 

MASKB($000F) 

TEMP(2) 

A 

I 

=XCARD 

=N$1A03 

-1 
-1 

-1 

4 

TEMP 

-1 

TEMP+1 

8 

=XMASKB 

TEMP 

AA.I 

TEMP+1 

8 

=N$FF00 

TEMP 

-1 

TEMP+1 

4 

=X$00FF 

TEMP 

AA+1,1 

TEMP+1 

=XMASKB 

12 

TEMP 

-1 

=N$0FFF 

TEMP 

AA+2,1 

I 

3 

I 

-54 

1 

LOOP 

=XCARD 

*+3 

=N$7FFA 

1 

SECOND 



SEL EQUIP 5 F 



CLR CON CLR INT RM H TO A 

OUTPUT FUNCTION 
PREPARE FOR DATA INPUT 

INPUT TO A FHIST COLUMN (12) 
DATA UPPER 1 1 BITS . . . ZERO 

INPUT 2nd COLUMN 
SAVE THE DATA 
UPPER 4 BITS IN LOWER 4 
ZERO UPPER 12 BITS 
FffiST WORD PACKED 



LOWER 8 BITS IN UPPER 8 BITS 
ZERO LOWER 8 BITS 

INPUT 3rd COLUMN 

UPPER INPUT 8 BITS IN LOW 8BITS 
ZERO UPPER 8 BITS 
PACK 2nd WORD 
PLACE IN BUFFER 

ZERO UPPER 12 BITS 

LOWER 4 BITS IN UPPER 4 BITS 



THIRD WORD PACKED 

GET INDEX 
UPDATE INDEX 



IF END OF CARD SKIP 
CONTINUE 



03FF 
0004P 



CARD 
LOOP 



0281 
000CP 



MASKB 000F TEMP 0000P 
DONE 003EP 



c 
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12.6 1742 LINE PRINTER 



The 1742 Line Printer (the Holley HR-300 Printer) prints 300 lines per minute, each 
line being 136 characters. The printer accepts ASCII codes with two characters per 16 
bit word. The printer has a holding register capable of accepting an entire line before 
printing: 136 characters (8 bits) or 68 words (16 bits). The ASCII codes require 7 bits, 
therefore, the 8th bit is used as a print control bit. This bit on each character is set 
by the controller when the character is received. As the printer actually prints the 
character, the 8th bit is cleared. When all print control bits have been zeroed, the 
printer has completed the print operation and is ready to receive data from the computer. 
The programmer is not required to send the maximum number of characters to the 
printer. The printer accepts the characters sent by the program and blanks the re- 
maining positions prior to printing. 

The Q Register will address the printer in the following format: 



15 



11 10 



7 6 



1 



o 



w 


E 




D 



Q 



The W portion will equal zero. The equipment number will correspond to the equipment 
setting of the hardware switch on the controller ($0-$F). The D portion will direct the 
type of transmissions to and from the A Register. 

DATA 

D=00 indicates the transfer of data to the printer's holding register. It will always be 
issued with an OUT instruction. 

EQUIP 7, DATA 
PLACE DATA IN A 

DATA SENT TO PRINTER 



LDQ 


=N$03 


LDA 


DATA 


NOP 




OUT 


-1 



o 



12.6.1 LP Functions 

DIRECTOR FUNCTION 1 

D=01 denotes the transfer of Director Function 1, which allows the programmer 
to CLEAR PRINTER and CLEAR INTERRUPTS. It also provides the medium for 
selecting as many as three interrupts: DATA, EOP, and ALARM. 



15 




















5 


4 


3 


2 


1 






































1 


1 


1 


1 


1 



t ♦ t t ♦ 

I EOP I Clear Controller 
Alarm Clear Interrupts 



Data Interrupt 



12-29 



12.6.1 



LDQ 


=N$0381 


EQUIP 7, FUNC 1 


LDA 


FUNC1 


PLACE FUNC IN A 


OUT 


-1 


SEND FUNC 



DIRECTOR FUNCTION 2 

D=ll accompanied by an OUT instruction sends Director Function 2 to the printer 
from the A Register. 



LDQ 


=N$0383 


EQUIP, FUNC 2 


LDA 


FUNC2 


PRE SET A TO FUNC 


NOP 






OUT 


-1 


SEND FUNC FROM A 



15 


14 


13 


12 


11 10 


9 


8 


7 


6 


5 


4 


3 


2 10 


























| | 



t * t 

12 11 10 



8- Line Select 



+ ♦ 



t * ♦ 
6 5 4 



Print (Bit 0=1) 



Single Space 
(Bit 1 = 1) — 



Double Space 
(Bit 2 = 1) ► 

Format Level 
(Bit 3 - Bit 14) - 



8- Line Select 
(Bit 15 = 1) - 



♦ * t t t + 

3 2 | Print 

Single Space 

Double Space 

Level 1 



Commands the printer operation to begin. Once the entire 
line has been printed the operation is complete. The print 
command must be issued for each line printed. 

Advances the page by one line. 

Advances the page by two lines. 

This command causes paper motion. The paper is moved to 
the next hole punched in the specified level. The tape levels 
are used for formatting documents, as the levels may be used 
instead of the spacing commands. Level 1 usually specifies 
top of page while level 12 usually specifies bottom of page. 

This bit changes the logic to allow for 8 lines per inch rather 
than 6 lines per inch. Once 8 lines per inch has been selected 
it remains in effect until a MASTER CLEAR, CLEAR CON- 
TROLLER, or bit 15 is issued as a zero. 
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12.6.2 LP Status 

D=01 with an INP instruction requests status. 

LDQ =N$0381 EQUIP #7, STATUS 

NOP 

INP -1 BRING STATUS TO A 



o 



15 10 


9 


8 


7 


6 


5 4 3 


2 10 




1 




1 




1 | 1 | 1 


1 | 1 | 1 



6/8 Lines Coincident 



Protected 



t t t t t + 

I Ready 

Busy 

Interrupt 

Data 

End of Operation 

Alarm 



The status of the Line Printer notifies the program of the READY and BUSY states 
of the printer by setting bits and 1, respectively. Bit 2 indicates the existence 
of an interrupt, while bits 3, 4, and 5, designate which interrupt was generated. 
Bit 3 is the bit indication that the printer is prepared to receive data from the 
computer. Bit 4 notifies the program that an operation is complete, such as a 
print or top of form command. Bit 5 indicates an ALARM condition has occurred, 
such as out of paper, paper tear, fuse alarm, open interlock, or an illegal char- 
acter. Bit 7 corresponds with the Protect Switch on the printer. If the switch is 
on, bit 7 will be set and only protected programs will be allowed to use the printer. 
Bit 9, when set, acknowledges that a change from 6 to 8 lines per inch may be 
effectively made. 

12. 6. 3 Programming the Printer 

Programming the printer simply requires advancing the page to the desired print 
level. Once the page is positioned, data is sent to the printers holding register. 
Once the data has been sent to the printer, the print command is issued. When 
the printer completes the print cycle, the program advances the page by level 
selection, or spacing and outputs the next line. The programmer selects the top 
of page level (usually Level 1) once a page is complete. 



o 
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12.6.4 Example, 1742 Line Printer 



c 



0001 
-000?- 



oon? 

0004- 
0005 
0006 



FOOD 

OA-a-1- 
03FF 
F0 
0-7-A3- 



0007 
0008 
-G-009- 

0010 
0011 



v- 
.'00 01 
HO 00-2 

P0003 

P0004 
POOO ^ 
LOGO'S 0A08 
f-0 07 3FE 
-p000*-€fla4- 
P000Q 7FFA 
P000A 68?6 
PO00Q nftV < 



001? 
0013 
-0014- 
0015 
0016 



P000C *OFF 

hoooo oofc 

-P000-F-G9-1 1 
P000F 0R00 
P0010 03FE 
-P004 1 COrF 



0018 
0019 
00 ?0- 
00?1 
00?? 
-0-0^3- 



P001? 09FF 
P0013 oio? 
-P 001-4 OOF-F- 
POOl^ 18F8 
POO 16 0003 
POO 17 OA01 



00?4 

00?5 

-0-9-2-6- 

00?7 

00?8 

-002P- 



P001« 
'-0019 
P001A 
P001R 
P001C 
POOin 



03FF 
0A04 
3FF- 
0815 
01A1 
-4-8F-Q- 



030 
0031 



^OOlc 0000 
POO IP" ^448 
-^-00? 0-4-95-3- 
P0021 ?050 
POO?? 5?4F 
>' J 0?3 -4-7^P- 



PP [MT 



-WJ-- 



-OU-T- 



MFXTI. 



CMP 
OAT A 



N! A M 
--E-M-T- • 
LOO 

FMA — 
OUT 
LOO 

FN A 
OUT 

- LOA 

STA* 
— CL^— 

STA- 

IMO 
._ LOA*- 

NOP 

OUT 
— bOA- 

IMA 

SAZ 
...R.AQ-- 

JMP* 
I WO 

- EAIA 

OUT 
EN A 

..-OUT-- 
RAO* 
SOV 

__j_tP-a- 

SLS 
AI.F 



PRINT 

OPp4T -- - 

=N*-07«i EQUIP .15, FUNC 1 

CLR CONTROLLER 
EQUIP 15, FUNC 2 
LEVEL 1 TOP OF FORM 
=X*7FFF-5 LOOP FOR OVERFLOW - 
LINFCT 6 LINES PER PAGE 



-I 
-1 

=NS0783 

-1 



T 
-3 
__ £)A-TA, I 



ZERO INDEX. 
PRINTER FOR DATA 
2 ASCII CHARACTERS- 



CHECK WORD LOOP 

17 CHARACTER PER LINE 
SKIP IF COMPLETE 

NOT COMP ,- - UPDATE INDEX 

CONTINUE LINE OUTPUT 



-1 

— T- 

-$11 
NFXTL 

OUT 

3 LINE COMPLETE, FUNCTION 

,_4 PRINT-eOI#f AND — 

-1 

4 DOUBLE SPACE 

LINFCT UPDATE LINE COUNT 
CMP SKIP IF PAGE COMPLETE 

__._C.N-T CONTINUE IF PAGE- -WH- 



«,THIS PROGRAM i»/OPKS ON PRINTER 174?* 



HO 26. 4140 
->00?S ?057 

— ^40?-6-4F-5?— 
P00?7 4R53 
■P00?ft ?04F 

. „ ra n ? 9— 4F-?-fl— 



^00? A 
"0 0?« 

-^O0?e- 
poo?o 

P002F 
■ »0 0?r 



50^? 

494F 

^44-5- 

5??0 

3137 

347? 



3? 
0033 



^0030 ooni 



8SS 
FND 



LINFCT (1) 

PPINT 
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THIS PROGRAM WORKS ON PRINTER 174? 
TMTc; ppor.RftM wopks OM POINTER 17 4 ? 
TWIS PROGRAM WORKS OM PRINTER 174? 



THTS PROGRAM .WORKS'.- ON. PRINTER 174? 
THIS PPOOW' 1 WQPKS ON PRINTER 174? 
THIS PROGRAM WORKS ON PRINTER 174? 



Note what happens in the following program when the functions for print command 
and double space are issued simultaneously! (Line 23, ENA 5.) 
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0001 

000? 



NAM 
E MT 



PRINT 
- PRINT 



0003 

--Q-0-A4 
0005 
0006 



POO.OO 

P000 3 
PQ0 04 



07 

8 

-0-0-0r9- 

0010 



pnoo*> 
P0007 

^0-008-- 
P00 09 
P000A 



fooo 

^7Q] 
.-QA£4— 

3FE ' 

EO^O 
417-AO— ■ 

OA08 

03FF 

•£0-0-£— 
7FFA 
68: ?4 
844 — 



PRINT 



LDQ 



-IP44- 



=NS078'1 



.CL-R-CONT— 



OUT 
LOQ 



-1 

=N$0783 



EN A 

OUT 

-4_-£A- 



-€-N4"- 



STA* 

CLR 



8 
-1 

LINECT 

J* — : 



TOD OF FORM 



001? 
0013 
-9-0-1-4- 
C015 
0016 



P c 
P00QO 

POOO^ 
P0010 



60FF 

ODFC 

G-90F- 

0R00 

03FE 

-^MVF-F- 



tWF- 



STA- 
IMQ 



I 
-3 




P-R-Q^e AM -jgggKS-QM-P PINTER 1742* 



0030 
031 



P ? A 
PQG?R 

POO 20 
R00?E 



54^-5 
S??0 
-3-3^7- 
343? 
001 



8SS 
-E-H9- 



LINECT(I) 

PQJMT 
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MTc; PROGRAM OPK5 ON PRIM ^P 1.74? 

HT<; PROGRAM ''ORK5 ON PRIM FR 174? 

__H41^_£iP^<^^IyL. ^ — 1-7-AP- 

MT^ pPQGPAM 'ORKs OM °PIN' FR 174? 

HI P OG AM '^0 K OH P IN F 174? 



Digigraphics - September 1969 
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12.7 1738/853 DISK 

The disk is a buffered peripheral device attached to the 1705 Direct Access Bus. All 
data will be buffered in and out of memory via the 1705 in 16-bit words. The functions 
will be sent from the A Register and status will be received in the A Register, nec- 
essitating the connection to the A/Q channel. The disk transfers 16-bit data words in 
12. 8 microseconds. Access time for positioning the head is 165 milliseconds maximum. 
Cylinder- to- cylinder pos itioning time is 30 milliseconds. The disk has a maximum 
latency time of 25 milliseconds. 

Ninety-six 16-bit words may be stored on one sector with 1,536 words on a track and 
15, 360 words to a cylinder. The 853 disk pack allows a total of 1, 536, 000 words, while 
the 854 disk pack has a capacity of 3, 118, 080 words. 

The data format may be summarized in the following: 

16 Bit data words 

96 Words to a sector 

16 Sectors to a track 

10 Tracks to a cylinder 

100 Cylinders to an 853 file 

203 Cylinders to an 854 file 

The three interfaces for communications with the 1738 controller are the A/Q channel, 
DAC (1705) and the CONTROLLER/FILE. The A/Q channel is the interface between 
the controller and the programmer. It is via the A/Q channel that the programmer 
may status the disk and issue functions. The DAC is the interface between the controller 
and the computer's memory. It is via this channel that the data is transferred. The 
DAC also provides the 1738 access to the LWA+1 of the programmer's buffer area. 
CONTROLLER/FILE INTERFACE is used for communications between the controller 
and the disk. It is through this interface that the controller informs the disk of the 
Sector Record Address selected by the programmer. The SEEK operation which posi- 
tions the read/write heads to the SECTOR RECORD ADDRESS is generated by the 
controller once the controller receives the desired address from the A/Q interface. 
The controller will issue a SEEK FORWARD or SEEK REVERSE command depending 
upon the current position of the read/write heads. It does not return to a set address 
prior to positioning on a new address. 
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SIDE VIEW: 
850 DISK PACK 
(6 DISKS) 



DISK SURFACE 

DISK SURFACE 1 

4_: 

~*~ 

* — 

4 

* DISK SURFACE 9 



O 



TOP VIEW: 
DISK SURFACE 



CYLINDER 00 



CYLINDER 99 




DIRECTION OF 
ROTATION 



853 contains 100 cylinders; 854 contains 203 cylinders. 



Figure 29. Disk 



o 



SECTOR 14 
SECTOR 15 
SECTOR 
SECTOR 1 
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Figure 30. Sector Format on Disk 



ADDRESS 



DATA 



*$ 



\NO£D 



HEAD 
GAP 



SYNC 




CHECKWORD 



Each sector on the disk contains the above information. Note that the 96 16-bit words 
of data (1536 data bits) are in addition to the other check bits in the sector. 
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Figure 31. Data Buffer for Disk 



O 



FWA 



LWA 




> DATA 



J 



o 



FWA-1 must contain LWA+1 of buffer. 
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The Q Register will contain the address of the disk. 

15 11 10 7 6 5 4 3 2 

Q 



'°, 






'o 


X 


E 


X 




'o, 


X 


D 



v \s 

W Equipment Director Bits 

W field is zero and E field contains equipment number (set on controller). 

The setting of the director bits will define the desired operation to the controller. 
The contents of the A Register will vary according to the director bits. 



12. 7. 1 Disk Functions 



DISK FUNCTION CODES 



Value Set in Q 






(Bits 02 - 00) 


Output from A 


Input to A 


001 


Director Function 


Director Status 


010 


Load Address 


Address Register Status 


011 


Write 




100 


Read 




101 


Compare 




110 


Checkword Check 




111 


Write Address 





12.7. 1. 1 Director Bits 001 - Director Functions 

This setting with an OUT instruction prepares the controller for director functions 
which are found in the A Register. The functions for the disk may all be sent at 
the same time. 



15 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 

















| | 





Unit Select Code 
Unit Select — 
Release - 



t t 

| Clear Interrupt 
Ready & Not Busy Interrupt 
End of Operation Interrupt 
Alarm Interrupt 

The CLEAR INTERRUPT function will clear all selected interrupts allowing the 
programmer to select the interrupts he desires. Three interrupts maybe 
selected: NEXT READY AND NOT BUSY STATUS, END OF OPERATION, and 
ALARM. The NEXT READY AND NOT BUSY interrupt occurs when the 1738 
becomes not busy, but still maintains its ready status. This interrupt can be used 
during an overlap seek. The overlap seek is used when two disks are connected 
to one controller. The programmer may issue a sector record address for one 
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disk and then issue a sector record address for the other. The controller will 
generate a NEXT READY AND NOT BUSY interrupt, if selected by the programmer, 
when one of the disks reaches the requested address. 

The END OF OPERATION interrupt allows the controller to inform the 1700 when 
it has completed an operation such as a data transfer. The ALARM INTERRUPT 
will notify the 1700 that an alarm condition has arisen. There are eight possible 
alarm conditions; not ready, checkword error, lost data, seek error, address 
error, defective track, storage parity error, and protect fault. 

The RELEASE function allows an unprotected program to use the disk even though 
the protect switch on the disk is still set. A protected program must issue the 
release function. The next time a protected program accesses the disk, the disk 
will become protected and must again be released before the disk will become 
accessible to an unprotected program. 

The UNIT SELECT and UNIT SELECT CODE will always be zero unless two disks 
are connected to the 1738. Bit 8 is the UNIT SELECT bit which informs the con- 
troller that the program will select unit or unit 1. Bit 9 indicates which unit 
bit 8 wishes to select. If bit 9 is a 0, unit is selected; if it is a 1, unit 1 is 
selected. The controller ignores bit 9 unless bit 8 is set. 

12.7.1.2 Director Bits 010 - Sector Record Address 



This director code in the Q Register with an OUT instruction will send the SECTOR 
RECORD ADDRESS from the A Register to the controller. Once the controller 
receives the address, it initiates the seek operation. The SECTOR RECORD 
ADDRESS will be in the following format: 

15 8 7 4 3 

A 



CYLINDER 


HEAD 


SECTOR 



o 



12. 7. 1. 3 Director Bits 011 - WRITE 

The WRITE function code requests the controller to prepare to read data from 
memory and write it on the disk. Prior to this function, the programmer must 
send the SECTOR RECORD ADDRESS to the controller. 

The controller expects to find the first word address minus 1 (FWA-1) of the buf- 
fer area in the A Register when the write function is received. The controller 
goes into memory via the DAC to the FWA-1 at which location he extracts the last 
word address plus 1 (LWA+1). The controller keeps the LWA+1 and updates the 
FWA-1 until the two are equal at which point the write operation is complete. 

Prior to issuing the WRITE function, the SECTOR RECORD ADDRESS must be 
sent to the controller and the LWA+1 of the buffer area must be at the FWA-1. 
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12.7.1.4 Director Bits 100 - READ 

The READ function code follows the same programming procedure as the WRITE 
function. The difference being the disk reads data into memory rather than 
writing data on the disk. An unprotected program may READ from a protected 
disk without generating a protect FAULT, however, if an unprotected program 
attempts to write on a protected disk, a protect fault will occur. An alarm in- 
terrupt will be generated if previously selected. 

12. 7. 1. 5 Director Bits 101 - COMPARE 



The COMPARE function code follows the same programming procedure as the 
READ and WRITE function codes. The COMPARE function causes the controller 
to read data from the computer's memory and compare it with the data stored on 
the disk. If at any time during the compare, one word does not compare, the NO 
COMPARE status bit will be set. This function provides an extra check on the 
validity of the data transferred. 

12. 7. 1. 6 Other Director Functions 



The remaining director functions (CHECKWORD CHECK and WRITE ADDRESS) 
are used by the customer engineers for maintenance work. 

12.7.2 Disk Status 



12. 7. 2. 1 Director Status 



D = 001 accompanied by INP instruction, will request the 1738 to send status to 
the A Register. 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 10 




























| | 



4 4 
Protect Fauit 
Storage Parity Error 

Defective Track 

Address Error 

Seek Error 

Lost Data 
Checkword Error 



4 * t t t t ♦ 

I Ready 

Busy 

Interrupt 

On Cylinder 

End of Operation 

Alarm 

No Compare 

Protected 
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The READY status indicates that the unit is available. The BUSY bit indicates 
that the controller and/or the drive unit is presently involved in the performance 
of an operation. This bit is set with the acceptance of a LOAD ADDRESS, WRITE, 
READ, COMPARE, CHECKWORD CHECK, or WRITE ADDRESS function. At the 
completion of the function which set the BUSY status, the status will be cleared 
and the disk will become NOT BUSY. Once the disk is NOT BUSY, a new function 
may be issued. 

The INTERRUPT bit acknowledges that an interrupt has occurred. Further ex- 
amination of A will determine which of the three selected interrupts was generated; 
bit 4 (EOP) and bit 5 (ALARM). If neither bit 4 nor bit 5 is set, the programmer 
should check bits and 1 for READY and NOT BUSY. If the alarm bit is set, the 
programmer must evaluate A further to determine which of the eight alarm con- 
ditions caused the interrupt. 

The ON CYLINDER status, bit 3, is set when the READ/WRITE heads have 
reached the SECTOR RECORD ADDRESS initially sent to the controller via the 
A/Q channel. 

12.7.2.2 Address Register Status 



O 



The D=010 Q setting accompanied by an INP instruction will direct the controller 
to return the current sector record address of the disk to the A Register, the 
location at which the READ/WRITE heads are currently positioned. It will be in 
the same format as described in the Address Function. 
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12. 7. 3 Disk Sample Programs 



0001 



000? 

0003 P0000 C000 DISK 
P0001 OOP? o 

-0M^r-fW?-frft&fl 

P0003 00?E 
0005 P0004 D800 
P0W5HWH- — 



NAM 
-EM-T- 



DISK 



LOA =XL«'PO 



S-TA — -FWMO — 



RAO FLAG 



0006 P0006 E000 
PO'007 01R1 

ftn n? pnftnn H A ft "** 

0008 P0009 03FE 

0009 POO0A-E000 



LDQ =N$01R1 



ZAP 



-E-NA- — £O0#2 

OUT -1 

LDQ =N$0182 



— pow^-e-tf*-?- 

0010 P000C 0A10 

0011 P000n 03FE 
-0-0+2-PO-0« E-E-0 O-O- 

P000F 0181 

0013 P0010 0B00 

0014 P0011 4P/F-E- 



ENA $0010 
OUT -1 
-fcDQ — =W)l-8Lr- 



-ST-^T- 



NOP 
-TMP 4- 



0015 P001? OFCC 

0016 P0013 0131 
--ftO17-P-0-0-L4~-4 8F€- - 

0018 POOLS 1C00 

0019 P0016 0000 

2 P OO 17 001 9 n 



FLAG 



ALS IP 

SAM 1 
-dMP*- - STAT 
MUM S1C00 


-adc- write- 



0021 P001« OOPA 

00?2 POOl^ cooo 

POO 1 A 0031 



WRITE 



ADC READ 
LDA =XFWMQ 



0023 P001R E000 
P001C 0183 
-frO-P4 POO l D -BB-frO- 



LDQ =N$0183 



-NOP- 



00P5 P001E 03FE 
0026 P001F E000 
P 0-020 01 8 b- 



0027 P0021 .0B00 

0028 P0022 0?FE 
-^0P9--P00^8 OFCO 

0030 P0024 0131 
.0031 P0025 18FC 
-0^32— PO 026-000 0-- 

0033 P0027 D800 
P0028 FFED 

0034 P002 9 10r O- 



XX 



LOOP 



OUT -1 

LDQ =N$0181 



MOP 

INP -1 
-AL-S- — H— '- 

SAM 1 

JMP* LOOP 
-5L-5 — r~ 

RAO FLAG 

— JMPo ZA P 



0035 P002A COOO 
P002R 0031 

003 6 ftfrOee— EOOO- 
P002D 0184 

0037 P002E 0900 

?003Q P00?r 03rc 




i 0041 P0032 00 6 



READ 



LDA =XFWMO 



— bBQ—- =N$04-84-- 

. NOP 

— OUT 4 



039 P0030 18EE 

040 P0031 0001 



JMP* 
B7S 



XX 
FWMO(l) 



-&Z-S — FWA4-964- 



042 P0092 0001 

043 ~^-— - — = 



BZS 
END 



LWPO(l) 
DISK 



LWA+1 IN T A' 

LWA+1 AT FWA-1 

UPDATE FLAG FOR LOOP 

EQUIP 3, FUNCTION 
GLR INT 

EQUIP 3, LOAD ADDRESS 
CYL 0, HEAD 1, SECTOR 
EQUIP 3, STATUS 



STATUS IN A 

ON CYL 

SKIP WHEN ON CYL 

WAIT 

JMP (0) 



-£& WRITE 

GO READ 
FWA-1 IN A 

EQUIP 3, WRITE 



EQUIP 3, STATUS 



STATUS IN T A T 

CH FOR END OF OP 

SKIP WHEN COMP 

WAIT 

STOP TO ZEROi BUF FROM CONSOLE 

ADD 1 FLAG READ 



-CONTINUE, HEAD 
FWA-1 IN A 

-EQUI2- 3, READ 



GO STATUS FOR END OF OP 
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oooi 
ooog 



POOOO EOOO — STA R T 



NAM 

-tm- 



OISK 
=N«S0101 



EQUIP 3, F UNCTION 



P0001 0181 








1 0003 P000? 0844 


CLP 


A 


INITIALIZE INDEX 


AnflA pfinm a n r~ r 


CTfl -, 


T 




TDUU"f l UUUJ Our r 




I 




! /0005 P000A cooo 


LDA 


=N$0002 


CLEAR INTERRUPTS 


f P00 05 0002 








'0006 P000O 0000 


NOP 







0007 
0008 



P0007 
P0008 



03FE 
E000 



3UT 
LDQ 



-1 

=N$0182 



SECTOR RECORD ADDRESS 



P0009 0102 



P' 



0009 



P000A 
POOOB 



C000 
0460 



LDA 



=N$460 



CYL 4, HEAD 6, SECTOR 



'0010 PO00C 0B00 — 


-HBP 






0011 P000D 03FE 


OUT 


-1 




i 0012 P000F E000 


LDQ 


=N$0181 


EQUIP 3, STATUS 


l. pooor oioi — 









0013 
0014 



P0010 
POOH 

42- 




0B00 

02FE TEST1 
F43- — 



NOP 

IMP 

■ARS- 



-1 

-3— 



STATUS IN A 
CHECK ON CY L- 



AND 



-&AU- 



= XMSK 



WRITE 



-SKXP-C-F-O N CYL 



WRITE 



JMP* 
LOA 



TEST1 
=XBUF+96 



WAIT UNIT ON CYL 
LWA+1 



;0021 P0Q1O C000 



P0019 
P001A 



6800 
003C 



;ta 



-L-0A- 



BUF-1 



=X B UF - 1 



0022 



P001C 
P001D 



0056 P 
EOOO 



STORE AT FWA-1 
LOAD -*-A^-FWA-l- 



LDQ 



P001E 0103 



=N$0183 EQUIP 3, WRITE 



0023 
0024 
0025 



P001F 
P0020 



0B00 
03FE 



P0021 EOQO 



NOP 
OUT 
-fcBG- 



-1 

- ^NSOlOl 



-EQUIP; -3-r- STAT U S 



0026 



P0022 
P0023 



0181 
0800 



TEST2 



POO 24 Q2FC 



NOP 
-£MP- 



— h 



STATUS IN A 
CK END OF OP 



0028 
0029 



P002S 
P0026 



0F44 
A000 



ARS 

AND 



4 
= XMSK 



P0027 0001 



^0030 
[0031 

1 0032 



P0028 
POO 29 



0111 
18F9 



POO? A 0044 



Z ER O 



SAN ZERO SKIP WHEN COMPLETE 
JMP* TEST2 CONTINUE WAITING ■-' 
-GtR A— ZERO BUFFER AREA 



0033 



P002B 
P002C 



6900 
002B 



STA 



BUF,I 



i0Q34 P002D DOFF 


: RAO- 


t— 


— UFDATE-I — — — 


0035 P002E C000 


LDA 


=XCOUNT 




P002F 0060 








0036 P0030 90FF — — 


SW 


r 





0037 
0038 



P0031 
P0032 



0132 
1800 



SAM 
JMP 



READ 
ZERO 



IF COM SKIP 

CONTINUE ZERO UNTIL COMPLETE 



P0033 TFr6 



0039 
S0O4O' 



P0034 
P0035 
P0036 



0000 
EOOO 
0182 



READ 



SLS 
LDQ 



=N$0182 



STOP TO CK BUFFER 
EQUIP 3, LOAD ADDR 
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0041 



P0037 
3Q03 Q 



CO0O 



LDA 



=N$460 CYL 4, HEAD 6, SBG 



004? 
0043 
-0-044- 



P003Q 
P003A 
PQ03^ 



0B00 
03FE 
EQOO 



TEST3 



NOP 
OUT 



-1 

-NS0181 E QUIP 3, STATUS 



0045 
00 'i 6 



P003C 
P003D 
pnQ3c 



0.1 81 

OBOO 

o?FF 



NOP 



__4_ 



STATUS IN 'A* 



0047 
0048 



P003F 
P0040 

Si. 



0F43 
a 000 



ARS 

AMD 



3 

= XMSK 



CK ON CYL 



.00 4 1. oooi 



0049 
0050 

0051 



P004? 

P0043 



nQQ44 CQQ 



0111 
18F7 
rnnn 



PEAD1 



SAN 
:JMP* 
LDA 



READ1 SKIP WHEN ON CYL 

TEST3 WAIT 

=XBU5>1 FWA - 1 IN T A T — 



P0045 0056 P 
005? P0046 EOOn 
— P00 4 7 018 4 



LDQ 



=N$0184 EQUIP 3, READ 



0053 
0054 

-tHV5S- 



PO048 OBOO MOP 
P004Q 03FE OUT 

^ 0044 FOOO TEST4 bfM3- 



-1 OPERATION INITIATED 
sNSO'181 EQTOP 3, STATUS 



P004« 0181 

0056 P004C OBOO 

0057 P00 4 03FE 



NOP 



^L 



STATUS IN A 



0058 P004E 0F44- 

0059 PQ04F A00 
DQ050 0001 



ARS 
AND 



4 
XMSK 



CK END OP 



0060 
061 

0063 

06^ 



P0051 
P0 05? 



1 1 1 

18F7 

-noon 



-EXIX- 



SAM 
-Sk-S— 



u 0054 
P0055 



1800 
FFAA 
OOOI 



JMP 



-FPU 



EXIT SKIP WHEN COMP 
TEST4 . WAIT 
STOP 



START 



MSK(l) 



BEGIN AGAIN 



65 

0066 

-3-067- 

0068 



'005* 
W5-7- 



06 
^>06rO- 



FQU 
BSS 



C0UNT(96) 
(1) 



END 



Digigr aphic s - September 1969 
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12.7.3.1 Address Tag Program 



Write Addresses: 

Every new disk pack has to have addresses written on it before it can be used for 
data storage. Each sector must have an address tag. The hardware address tag 
switch and the write address function code are for writing the addresses. The 
following program could be used to write tags. 



NAM 



WRITE ADDRESS TAGS 



TAGS 



o 



LOOP 



EXIT 



TURN ADDR TAG SWITCH ON * DISK IS EQUIP 3 
FOR 854 CHANGE CYL EQU TO $CB 



EQU 

ENT 



LDA 

LDQ 

NOP 

OUT 

INQ 

ENA 

OUT 

INQ 

NOP 

OUT 

INQ 

ENA 

OUT 

INQ 

NOP 

INP 

EOR 

SAZ 

NOP 

INP 

JMP* 

SLS 

JMP* 

END 



EQUIP($0182), CYL($64) 

TAGS 



=N$0102 *SEL UNIT 0, CLR INT 

=XEQUIP-1 *DIR FUNC 



-1 

1 



-1 

5 

-1 

-6 



-1 

1 

-1 

=XCYL 

EXIT 

-1 
LOOP 

TAGS+1 



*SEEK FUNC 010 
*ADDRESS 0000 

*WRITE TAG FUNC 111 



*DUMMY DIR FUNC 001 
*LAZY MAN'S BUSY CK 



*FALLS THRU WHEN BUSY 
*LOAD ADDR FUNC 010 

*NEXT ADDR IN A 
*FINISHED? 



*GET NEXT ADDR BACK 

*STOP 

*GO DO IT AGAIN 
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Usually the program to write tags is keyed in from the console rather than run in 
assembly language. Therefore, it would be desirable to shorten the program. 
Error checks can be eliminated if the hardware is functioning properly. The 
following code is used by the customer engineers: 

E000 
0182 
2FE 
0D0 5 
3FE 
0DF9 
0A00 
3FE 
18F7 

Decode the program and see what it does. A master clear sets the disk at address 
0000 to begin. The program will stop on alarm when it is finished and is attempting 
to write an address beyond the last cylinder (on an 853 or 854). 

12.7.4 Problem 



Write a program to write zeroes on the entire disk pack after the new address 
tags have been written. Include error checks. 



12.8 1751 DRUM CONTROLLER 

The 1751 Drum Controller interfaces with drums ranging in size from 65,536^ words 
to 8, 388,508-^0 words. The drum word size is 20 bits composed of 16 data bits, 1 parity 
bit (odd), 1 protect bit and 2 spacing bits. 



DRUM 
WORD 



19 


18 


17 


16 


15 















DATA BITS 



I 

Spacing | Parity 
Protect 

The transfer rate for one word is 8 microseconds. All data transfers to and from the 
1700 are via the DAC. The access time for the drum is 8 milliseconds, with a maximum 
of 16 milliseconds. 

The Q Register will be in the following format when addressing the 1751. 

15 11 10 7 3 

Q 



w = o 


E 


>:::::::::::§::::!:;:;:!:;:; 


D 
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The D portion of Q determines the type of information being sent or received in the A 
Register. The INP and OUT instructions, accompanied by the Q setting, control the 
information flow to A (INP) and from A (OUT). 



Figure 32. Interim Drum Interface Codes 



O 



1700 I/O 


CO 

o 


O 


iH O 

o o 


DESCRIPTION 


Write 


X 


X 


X 1 


Director function 

A = Not used 

A = 1 Clear Interrupt 

A = Not used 

A = 1 End of Operation Interrupt Request 
o 


























Write 





a 


b 


Initiate Operation 













ab = 00 Write Data From Core 










1 


ab = 01 Write Zeros 







1 





ab = 10 Read Data to Core 







1 


1 


ab = 11 Check Parity on Drum 


Write 


1 


a 


b 


Load Address Register 




1 








ab = 00 Track 




1 





1 


ab = 01 Initial Sector 




1 


1 





ab = 10 Initial Core 




1 


1 


1 


ab = 11 Final Core 


Read 


X 


X 


1 


Director Status I 
A = 1 Ready 
A = 1 Busy 
A = 1 Interrupt 
A = • Not used 
A = 1 End of Operation 
A_ = 1 Not used 
A = 1 Lost Data 
A = 1 Protected 


































































A = 1 Parity Error 

A = 1 Not used 

A = 1 Guarded Address 

A = 1 Timing Track Error 




























X 


X 


1 1 


Director Status II 

A .- A„., Sector Address 
11 
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12. 8. 1 Drum Functions 

When the D portion equals 000 1 2 accompanied by an OUT instruction, the A Register 
must be preset. The setting of A determines the function or functions to be sent 
to the 1751. 



A 






| Clears Interrupt 

EOP Interrupt 



The Clear Interrupt bit clears the interrupt. The EOP INT (End of Operation 
Interrupt) takes precedence over the CLR INT. When the EOP bit is set, the 1751 
will generate an interrupt when it has completed an operation. The remaining 
bits in A are not used, therefore, they should be set to zeros. 



When programming the drum the programmer first clears interrupts, 
in interrupt mode, he should also select the EOP interrupt. 



If writing 



LDQ 


=N$0101 


EQUIP 2, DRUM FUNC 


ENA 


$000A 


CLR INT, SEL EOP 


OUT 


-1 


OUTPUT FUNCTION 



Once the interrupts have been cleared and reselected, the programmer must tell 
the controller the first word address (FWA) of his buffer area in core memory, as 
well as the last word address (LWA) of the core memory buffer. This is accom- 
plished by two D settings: D = 1100 2 denotes FWA, D = 1H0 2 indicates the last 
word address. These settings are accompanied by an OUT instruction with the 
address preset in the A Register. 



LDQ 


=N$010C 


EQUIP 2, FWA 


LDA 


=XFWA 


A = FWA 


NOP 






OUT 


-1 


OUTPUT ADDRESS 


LDQ 


=N$010E 


EQblP 2, LWA 


LDA 


=XLWA 


A = LWA 


NOP 






OUT 


-1 


OUTPUT ADDRESS 



The controller then knows the area and length of the computer buffer area. Once 
the controller knows the memory limits, the programmer must give the drum 
area by sending the beginning track address and sector address. Both are sent 
from the lower 12 bits of the A Register. The D portion of the Q Register dis- 
tinguishes between sector and track address: D = 1000 indicates TRACK, 



r 

v 
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o 



D = 10 10 2 specifies sector. The programmer may select any one of 4096^q tracks. 
(Note: Not all systems have the maximum number of tracks, therefore, check 
your configuration.) The programmer may select one of 2048-^q sectors. (A sec- 
tor is the drum address of a word within a track. ) 



LDQ 


=N$0108 


EQUIP 2, TRACK ADDR 


ENA 


$0004 


TRACK 4 


OUT 


-1 


OUTPUT TRACK NUMBER 


LDQ 


=N$010A 


EQUIP 2, SECTOR ADDR 


ENA 





SECTOR 


OUT 


-1 


OUTPUT SECTOR NUMBER 



The controller now knows the core memory and drum memory to be used for an 
operation. The programmer must now specify one of four operations. The op- 
erations are also indicated by the D setting of the Q Register in conjunction with 
an OUT instruction. The four operations are as follows: 

D = 0000 initiates a write operation. This write operation instructs the 
1751 to write data on the drum from core memory. 

D = 0010 instructs the 1751 to write zeros on the designated drum area. No 
data is transferred from memory. 

D = 0100 initiates a read operation. The read operation transfers data 
from the drum to core memory. 

D = 0110 initiates a check operation. The check operation causes the 
designated drum area to be read and checked for parity errors 
without any transfer of data into core memory. 



LDQ 


=N$0100 


EQUIP 2, WRITE 


NOP 






OUT 


-1 


INITIATE WRITE 


LDQ 


=N$0102 


EQUIP 2, WRITE ZEROS 


NOP 






OUT 


-1 


INITIATE ZERO WRITE 


LDQ 


=N$0104 


EQUIP 2, READ 


NOP 






OUT 


-1 


INITIATE READ 


LDQ 


=N$0106 


EQUIP 2, CHECK 


NOP 






OUT 


-1 


INITIATE CHECK 



■y 
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The drum at this point will be in the process of performing an operation. If the 
END OF OPERATION interrupt were selected, the 1751 will generate an interrupt 
when the operation is completed. 

12. 8. 2 Drum Status 



The programmer may take status while the operation is being performed in order 
to monitor the progress of the operation. He may also take status again at the end 
of the operation to verify an error free operation. 



12. 8. 2. 1 Director Status I 

Status maybe requested by a D setting of 0001 2 accompanied by anINP instruction. 
The status will be brought into the A Register. 

EQUIP 2, DIRECTOR STATUS 
BRINGS STATUS INTO A 



LDQ 


/ =N$0101 


NOP 




INP 


-1 





15 


14 


13 


12 


11 


10 


9 


8 


r 


r 


6 


5 


4 


3 


2 


1 





A 


Wvi 


:j:|:0:j: 


£:•:•:•: 


i:+ii 


1 


1 




1 


1 


1 




1 




1 


1 


1 




t i 


\ t \ 


\ ♦ 


♦ 


* t ♦ 
INT 1 Re 


Timing Track Error 


Parity 


Lost 


EOP 




Error 


Data 




Busy 




( 


juai 


:dec 


Ad 


dres 


;s 








I 


>r 


otec 


ted 













A 1 in the corresponding bit indicates that the stated status exists. For example, 
a 1 in bit 11 indicates a timing track error. 

Timing Track Error 

Bit 11 is an error in the timing track which insinuates a hardware problem. 
The programmer should attempt the operation three or four times before 
accepting the status as a hardware failure. 

Guarded Address 

Bit 10 indicates that a core to drum transfer was attempted to a track with an 
address lower than the one set on the track protect switch. 

Parity Error 

Bit 8 indicates that the parity was not odd, i. e. , it did not have an odd num- 
ber of one bits in the word. 
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Protect 

Bit 7 indicates that the protect switch on the drum has been set. 

Lost Data 

Bit 6 indicates that data was not transferred from the controller's holding 
register before new data was read into the register. 

EOP 

Bit 4 notifies the programmer that an operation has been completed. 

Interrupt 

Bit 2 indicates that an interrupt has been generated by the 1751. 

Busy 

Bit 1 indicates that the 1751 is in the process of performing an operation. 

Ready 

Bit indicates that the controller is in a ready state. 

12.8.2.2 Director Status II 



LDQ 


=N 


NOP 




INP 


-1 



The programmer may also request the 1751 to send the current sector address of 
the drum to the lower 12 bits of the A Register. This is accomplished by setting 
D = 0011 and executing an INP instruction. 

EQUIP 2, SECTOR STATUS 
INPUT SECTOR ADDRESS 

12. 8. 3 Programming the Drum 

In summary, the programmer must first clear interrupts and select desired inter- 
rupts. Once this has been issued, the programmer notifies the 1751 of the first 
word address and the last word address of core memory. Then, he must send 
the track and sector addresses of the drum. Finally, he specifies the operation 
to be performed. Status may be taken during the operation to monitor the pro- 
gress and should be taken at the end of the operation to confirm that the operation 
was performed correctly. 

When data is being written on or read from the drum, the track address is auto- 
matically incremented when the sector address overflows to the next track. 
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Also, the Write Zeros and Check Parity functions operate on a specified area of 
the drum. Since only a beginning track and sector address were specified, the 
core address must be sent also to indicate the number of words, even though the 
data in core is not involved in those operations. 

Example : 

The following is a test program for the drum. It writes 100 words from a buf- 
fer beginning at FWA, on the drum beginning at track 4, sector 0. It then checks 
drum parity on the data written and reads it back in. 

To operate the program, the initial buffer should be set to all one bits from the 
console. The STOP switch should be set, and the program will stop before the 
Read. The buffer should then be cleared from the console. By setting the STOP 
switch again and continuing the RUN, the read will be done and the program will 
stop. Then the buffer can be swept from the console to see that the data was read. 

Note that the drum controller must be dialed to equipment #2 and that the drum 
address registers and memory address registers must be reset before each 
operation. 

Note also the nifty coding at lines 0026 - 0030 to jump different places on a flag. 



V 
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12.8.4 Drum Example Program 



12.8.4 



o 



o 



0001 



MAM 



DRUM 



0002 
0003 



P0 0O0 



DRUM 



ENT 
-0 



DRUM 
-0 



0004 P0001 

0005 P0002 



0AO1 
68 IF 



ENA 
STA* 



1 

FLAG 



FIRST JMP TO WRITE 



0006 P0003 0A02 

0007 P0Q04 EOO0 



ENA 



-0£ 



P0005 0101 
0B P0006 0B00 



$0002 CLEAR CONTROL 
=N$010 1 EQUIP 2 DIR FUNC 



MOP 



0009 
0010 



P0007 
POQOft 



03FE 
C0 



MEM 



OUT 
LDA 



•1 

JLEMA- 



T\^VVV.-R 



P0009 
0011 P0P0A 



03E 
£0 



LDQ 



=N$oinn 



FWA(CORF) FUNC 



P000H 010C 
0012 P0 00C QR0 



-WOP- 



0013 P000D 03FE 

ooi a pooob; cooo 



OUT 
-LOA. 



-1 

s;XFWfltqq 



LWA 



P000F 00A1 p 
0015 P0010 E000 



-LGO- 



= M$ninF T.WA(finBF) FTTNC! 



0016 



P0011 
P0012 



010E 
0B00 



-WOP- 



0017 P0013 03FE 

0018 P0014 C000 



ADDR 



OUT 

-k-OA- 



-1 

aN$fe 



TR ACK 



POO 15 04 
019 PO P] 6 EO0 



LDQ 



= N $ni OR 



TRACK ADDR FUNC 



P0017 0108 
0020 P0018 0B00 



-NOR- 



0021 

no?? 



P0019 

Pnnu 



03FE 
POOP 



OUT 
LDA 



-1 

=N0 



SECTOR 



0?3 



P001B 

pnmr 



0000 
EOOP 



Lno 



=ns(Ho a 



SECTOR ADDR FUNC 



P001D 

n o?4 pooiF 



010A 
P H H 



N OP 



0025 
nn?6 



P001F 
pnn?n 



03FE 
l run 



OUT 

MUM 



-1 

S1PPP 



JMP* (0) 



0027 P0021 0PO0 FLAG 
nn?R pnn?? pp?5 p ADC 





WR ITE 



WHERE TO JUMP 



0029 P0023 0033 P 

0030 pnn?4 0P3R p 



ADC 
ADC 



CHECK 
RFAD 



0031 P0025 0A00 
003? P00?<S FOOP 



WRITE 



ENA 
LDQ 




=N < EP1PP 



WRTTE DATA 



PPP27 P100 
0033 P0028 PROP 



NOP 



0034 P0029 03FE 

0035 P0P2A E000 



STAT 



OUT 
LDQ 



-1 
=N'R0ini 



DTR FUNC 



P002B 0101 
0036 poo?r, PROP 



MOP 



0037 P002D 02FE 
003 R P00?F O F CR 



INP 
ALS 



-1 
_LL 



INP STATUS 
CK EOP 



0039 P002F 0131 

040 PP03P 1R FC 



SAM 

■ JMP» 



1 
ST AT+3 



SKIP ON EOP 
WAIT ON EOP 



0041 P0031 D8EF 
nn4? po m? lrtns 



RAO* 

IMP* 



FLAG 
MFM 



NEXT JMP 

GO REINITIALIZE 



0043 P0033 E000 
PPP14 niOfi 



CHECK 



LDQ 



=N$01 06 CK PAR ERR ON DRUM (ONLY) 
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OO fr fr PQ035 OBOO WOP- 



0045 P0036 03FE OUT -1 

00 4 6 P0037 10rO zMP* ST-A-T GO WAIT ON EOF 

0047 P0038 0000 READ SLS CLEAR BUFFER FROM CON! 
00' i8 P0039 E000 bOQ =N$0104 READ FUNC 

P003A 0104 

0049 P003B OBOO NOP 

0050 P003C 03FE OUT -1 

0051 P003D 0000 SL-5 STOP AFTER READ 

0052 P003E 0064 FWA BZS FWA(IOO) SET BUFFER TO 1»! 

-0-0-&3 = ens mm 



-4 9-GF-f BfHW 000 OP MEM 0008P ADDR 0014P FLAG 0021P 

WRITE 0025P STAT 002AP CHECK 0033P READ 0038P FWA 003EP 



La Jqlla.- September 1968 
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12.9 1731/601 MAGNETIC TAPE 



12.9 



The 1731 magnetic tape controller is used with 601 tape transports. A maximum of 
eight 601's may be connected to one 1731. Buffering may be accomplished via the 1706. 

The 601 is a 7-track transport capable of reading or writing at 200 or 556 Bits Per 
Inch (BPI). The tape is moved at a rate of 37 1/2 inches per second. 

Reading and writing may be done in either Binary or BCD codes. The 601 accepts six 
bits of data and generates parity for the 7th bit. The parity will be odd for binary and 
even for BCD. 

The data is arranged in groups of records and files. Consecutive frames of information 
constitute a record. A record may consist of a minimum of one frame. A file is a 
group of records with the minimum being one record. Longitudinal parity (even) is 
generated on each record and stored four spaces past the last data character. A record 
gap is 3/4' of unrecorded tape surface which denotes the end of a record. A BCD 17 
code is placed six inches from the last record to indicate the end of a file. 

Each time a character is written by a 601, it transfers the character to the 1731 which 
checks the parity. If the parity is incorrect, the Parity Error status is set and an 
alarm interrupt is generated. (Note: The alarm interrupt will be generated only if the 
programmer has selected this interrupt.) The controller also checks for correct parity 
(j on a read operation. 

The Q Register will be in the following format when programming the 1731. 

15 11 10 7 6 2 10 

Q 

The W field will always be zero when going to the 1731. This field will be used for 
programming the 1706 which will be discussed later. The E specifies the equipment 
number of a 1731. The equipment number corresponds with a switch selection on the 
1731 ranging from to $F. (Check the equipment setting for your site. ) The D field 
specifies a command. 

12.9.1 D = 00 MTData 



C) 



w 


E 




D 



This setting specifies a data transfer. A write operation is indicated by an OUT 
instruction. The write sends the lower six bits of A to the 1731 which generates 
parity and writes the data and parity on the tape. Whenever the computer breaks 
the continuity of the character outputs, the controller initiates an End of Record 
sequence. If no new control functions are issued after the end of record is re- 
corded, tape motion stops. 

An INP instruction with D = 00 denotes a Read operation. The read operation 
transfers data from the tape to the controller. The controller checks parity and 
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sends the 6 data bits to the lower 6 bits of the A Register. The 1731 stops sending 
data to the computer when the computer stops requesting data or when the End of 
Record is sensed. Tape motion will not terminate except when the End of Record 
gap is sensed. 

If the 1731 is connected to the 1706, the data will be buffered into the computer's 
memory. The lower six bits of each word in the buffer area will contain data. 
The A Register will contain the FWA-1 of the buffer area for both read and write 
operations, therefore, the data transfer will always be initiated with an OUT 
instruction. The FWA-1 in memory must contain LWA+1 of the buffer area. 
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Figure 33. 1731 Functions 



D 


COMPUTER INSTRUCTION 


Output from A 


Input to A 


00 
01 
10 


Write 

Control Function 

Unit Select 


Read 

Director Status I 

Director Status II 



(A) - Control Function 



O 



MOTION CONTROL 
NOT USED I 



NOT USED 

ALARM INTERRUPT REQUEST 

END OF OPERATION INTERRUPT REQUEST 
DATA INTERRUPT REQUEST 
I CLEAR INTERRUPT 

CLEAR CONTROLLER 



I I 



10 



i 



\ ? 



Bits 10-7 




of A 


Motion Function 


0001 


Write Motion 


0010 


Read Motion 


0011 


Backspace 


0101 


Write File Mark 


1000 


Rewind Load 


1100 


Rewind Unload 







O 



(A) - Unit Select Function 



TAPE UNIT 
SELECT TAPE UNIT 
DESELECT TAPE UNIT 



NOT USED 



» 



NOT USED 

^SELECT 200 BPI 
rSELECT 556 BPI 

SELECT 800 BPI 
BINARY 
BCD 



I i 



NOT USED 



15 12 


1 1 


10 


9 7 


H 


5 


4 


3 


2 


1 


O 
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12.9.2 MT Functions 

12. 9. 2. 1 D = 01 Control Function 

This D setting, accompanied by an OUT instruction, indicates that the A Register 
contains control functions. The control function gives the programmer the capa- 
bility of clearing interrupts, c 1 e a r i n g the controller, selecting interrupts, and 
establishing motion control. All control functions may be issued together. The 
programmer is allowed to select three interrupts : Data, Alarm and End of 
Operation. 



15 11 


10 7 


6 5 


4 


3 


2 10 












| | 



Motion Control 



4 4 4ft 



CLR Controller 
CLR INT 
Data INT 
EOP INT 
Alarm 



0001 Write Motion 



Sets the write logic in the selected 601. Once the logic is set, a data 
transfer function must be sent with an OUT instruction in order for 
the data to actually be written on tape. 



0010 Read Motion 



Sets the read logic within the selected 601. A data transfer function 
must be sent with an INP instruction in order for the data to be trans- 
ferred to the A Register. 



0011 Backspace 



Causes the 601 to backspace one record. 



0101 Write File Mark 



Write file mark generates six inches of blank tape followed by a 17 8 . 
When the end of file mark is written or read, longitudinal parity is 
checked. If the controller is in binary mode, a parity error will be 
generated, as the 17 is in BCD mode (even parity). 



1000 Rewind Load 



The rewind controls bring the tape back to the magnetic load point 
indicator. The ready status stays up without any manual intervention. 
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o 



1100 Rewind Unload 

The rewind load keeps the ready status while the rewind unload causes 
the 601 to drop ready. 

12. 9.2.2 D = 10 Unit Select Function 

Allows the programmer to select the desired 601, density, and mode, when ac- 
companied by an OUT instruction. The 601 tape units can read at 200 and 556 BPI. 
The deselect function, bit 11, is used to deselect a protected 601 in order that an 
unprotected program mayget access to the 1731 to use an unprotected 601. 



15 12 


11 


10 


9 




7 


6 


5 


4 


3 


2 


1 
































Deselect Tape Unit 

Select Tape Unit 

Tape Unit 0-7 ' 




Bits in A 
4 4*4 Register 

BCD 
Binary 
Select 800 BPI 
Select 556 BPI 
Select 200 BPI 



The Select Tape Unit, Bit 10, indicates that the unit number in Bits 9-7 is to be 
the desired unit. If Bits 10 and 11 are not set, the controller ignores Bits 7-9. 



O 



12. 9. 3 MT Status 

12.9.3.1 D = 01 Status I 

This D setting brings Director Status I into the A Register when accompanied with 
an INP instruction. 



A 



15 13 12 11 10 


9 


8 


7 


6 


5 


4 


3 


2 10 


mmm&4 I I 
















| | 



I J | ! 



Controller Active 

File Mark 
Load Point 
End of Tape 

Parity Error 

Protected 



Ready 
Busy 
Interrupt 
Data 
End of Operation 
Alarm 
Lost Data 



12-61 



12.9.3.2 



12.9.3.2 D = 10 Status II 

Director Status II is requested with this D setting on an INP instruction. 
15 5 4 3 2 10 



A 



J 



Write Enable 

Seven Track — ' 



I 556 BPI 
800 BPI 



12.9.4 Magnetic Tape Example Programs 
12. 9.4.1 MT Example 1 



The following is a test program for a 601 magnetic tape on a 1731 controller. (It 
could also be used for a 608 tape on a 1732 controller. ) The program generates 
200 frames of data in the A Register and outputs 1 frame at a time (the lower 
order 6 bits of A) to the tape unit. The program then backspaces the tape and 
reads the data back in, s tor in g it in the buffer DATA. Each frame of data oc- 
cupies the lower 6 bits of a word in the buffer. 

The program can be run with the STOP switch set. It will stop when finished, and 
the buffer can be swept from the console. One cannot "step through" the program 
because the tape is moving as soon as the first tape motion command is issued. 



C 
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o 





NAM 


MT601 




LDQ 


=N$0382 


USEL 


LDA 
NOP 


=N$0494 




OUT 


-1 




INQ 


-1 


WRITEMO 


LDA 
NOP 


=N$81 




OUT 


-1 




LDA 


=N-200 




STA- 


I 




INQ 


-1 


DATA 


LDA 
NOP 


=N$FF 




OUT 


-1 




RAO- 


I 




LDA- 


I 




SAZ 


BACKSP 




JMP* 


DATA+3 


BACKSP 


INQ 


1 




LDA 


=N$0180 




NOP 






OUT 


-1 


READMO 


LDA 
NOP 


=N$0100 




OUT 


-1 




LDA 


=N-200 




STA- 


I 




INQ 


-1 


RDDATA 


NOP 






INP 


-1 




STA* 


DATA+200,1 




RAO- 


I 




LDA- 


I 




SAZ 


STOP-*-l 




JMP* 


RDDATA+1 


STOP 


SLS 





DATA 


BZS 
END 


DATA(200) 



Q382 



Q381 



Q380 



Q381 



EQUIP 7, UNIT SEL 
UNIT1,556BPI,BIN 



MOTION FUNC 

WRITE MOT, CLR CONT. 



200 FRAMES 

DATA FUNC 
DATA 3F 



MOTION FUNC 
BACKSPACE 



READ MOTION 



Q830 



DATA FUNC 
STORE DATA 



SWEEP BUFFER TO CHECK 
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c 

12. 9.4. 2 MT Example 2 - With Error Checks 

This test program for magnetic tape is the same as Example 1, with the addition 
of error checks. Note that the program never hangs in a loop on a reject. 

NOP 

OUT -1 

Instead it jumps to REJINT for any internal reject or REJEXT for any external 
reject. Even with no error analysis, note that considerably more coding is 
required just to allow for errors. Also note that the program is continually 
waiting for the tape. 

The program will stop either on normal termination or after a reject. It can be 
restarted after a reject by simply correcting the error condition and setting the 
RUN switch. 

This particular program has been run with the 1706 code set but it is still an un- 
buffered operation. The site where it was run had their magnetic tapes connected 
through the 1706, but the Direct Storage Access line was not also connected so 
operations simply went through the 1706 in unbuffered mode. 



C 
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/ 


0001 








0002 


P0000 


E000 






P0001 


1382 




0003 


P0002 


COOO 


Select . 




P0003 


0494 


0004 


P0004 


0302 




0005 


P0005 


1804 




0006 


P0006 


586A 




0007 


P0007 


5861 




0008 


P0008 


18F7 




> 0009 


P0009 


EOOO 






P000A 


1381 




0010 


P000B 


COOO 


/rite 




P000C 


0081 


/lotion 


0011 


P000D 


0302 


0012 


P000E 


1804 




0013 


P000F 


5861 




0014 


P0010 


5858 




0015 


poon 


18F7 




0016 


P0012 


COOO 






P0013 


FF37 




0017 


P0014 


60FF 




f 0018 


P0015 


EOOO 






P0016 


1381 




0019 


P0017 


0202 


Status < 


0020 


P0018 


1804 




0021 


P0019 


5857 




0022 


P001A 


584E 




^ 0023 


P001B 


18F9 




r 0024 


P001C 


OFCC 




0025 


P001D 


0131 


Data 


0026 


P001E 


18F6 


Ready? < 


0027 


P001F 


ODFE 




0028 


P0020 


COOO 






P0021 


OOFF 




> 0029 


P0022 


0305 




0030 


P0023 


DOFF 




0031 


P0024 


COFF 




0032 


P0025 


0104 


Output 
Data 


0033 


P0026 


18EE 


0034 


P0027 


5849 




0035 


P0028 


5840 




0036 


P0029 


18EB 




> 0037 


P002A 


EOOO 






P002B 


1381 




0038 


P002C 


0205 




0039 


P002D 


AOOO 






P002E 


0002 


Busy? < 


0040 


P002F 


0104 




0041 


P0030 


18F9 




0042 


P0031 


583F 




0043 


P0032 


5836 




^0044 


P0033 


18F6 




0045 


P0034 


EOOO 






P0035 


1381 



A2 



A4 



A5 



A55 



OUT 



A7 



A9 







12.9.4.2 


NAM 


TEST 


1706 


LDQ 


=N$1382 


EQUIP 7 
UNIT SEL 


LDA 


=N$0494 


UNIT 1, %%$ BPI, BINARY 


OUT 

JMP* 

RTJ* 


2 

A2 

REJINT 


GOOD 

INTERNAL REJECT 


RTJ* 
JMP* 


REJEXT 
A 


EXTERNAL REJECT 
RETURN AFTER REJECT 


LDQ 


*NS1381 


CONTROL FUNCTION 


LDA 


=NS0081 


WRITE MOT - CLR CONTROL 


OUT 


2 




JMP* 


A4 




RTJ* 


REJINT 




RTJ* 


REJEXT 




JMP* 
LDA 


A2 
=N-200 


EOR 200 FRAMES 


STA- 
LDQ 


I 
=N$1381 


DIR STAT 1 


INP 


2 


STATUS 


JMP* 


A55 




RTJ* 


REJINT 




RTJ* 


REJEXT 




JMP* 
ALS 


A5 
12 


DATA READY? 


SAM 


* + 2 




JMP* 
INQ 


A5 
-i 


WRITE DATA FUNC 


LDA 


»N$FF 


0000 0000 1111 1111 


OUT 


5 




RAO- 


I 




LDA- 


I 




SAZ 
JMP* 


A7-*-l 
A5 


GO STATUS AGAIN FOR DATA B 


RTJ* 


REJINT 




RTJ* 


REJEXT 




JMP* 
LDQ 


A5 
*N$1381 


DIR STATUS 1 


INP 
AND 


5 
*N$2 


CHECK BUSY 


SAZ 


A9-*-l 


SKIP WHEN NOT BUSY 


JMP* 


A7 




RTJ* 


REJINT 




RTJ* 


REJEXT 




JMP* 
LDQ 


A7 

=N$1381 


CONTROL FUNCTION 
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12. 


9. 


4.2 
















" 0046 


P0036 
P0037 


COOO 
0180 




LDA 


=N$0180 






0047 


P0038 


0302 




OUT 


2 


Backspace 


< 


0048 


P0039 


1804 




JMP* 


All 






0049 


P003A 


5836 




RTJ* 


REJINT 






0050 


P003B 


582D 




RTJ* 


REJEXT 






^ 0051 


P003C 


18F7 




JMP* 


A9 






K 0052 


P003D 
P003E 


EOOO 
1381 


All 


LDQ 


=N$1381 






0053 


P003F 


0202 




INP 2 








0054 


P0040 


1804 




JMP* 


Alll 






0055 


P0041 


582F 




RTJ* 


REJINT 






0056 


P0042 


5826 




RTJ* 


REJEXT 


Busy? 


< 


0057 


P0043 


1801 




JMP* 


Alll 






0058 


P0044 


0FCE 


Alll 


ALS 


14 






0059 


P0045 


0121 




SAP 


**2 






0060 


P0046 


18F6 




JMP* 


All 






0061 


P0047 


COOO 


LDA 


=N$0100 






c 


P0048 


0100 








Read 




0062 


P0049 


0302 




OUT 


2 


lVTotion 


< 


0063 


P004A 


1804 




JMP* 


A13 


lYl. vtlvll 


i 


0064 


P004B 


5825 




RTJ* 


REJINT 






0065 


P004C 


581C 




RTJ* 


REJEXT 






. 0066 


P004D 


18EF 




JMP* 


All 






f 0067 


P004E 


COOO 


A13 


LDA 


=N-200 


E-7 


<> 




P004F 


FF37 










i 


^ 0068 


P0050 


60FF 




STA- 


I 






r 0069 


P0051 
P0052 


EOOO 
1381 


A14 


LDQ 


=N$1381 






0070 


P0053 


0202 




INP 


2 






0071 


P0054 


1804 




JMP* 


A44 


Data 




0072 


P0055 


581B 




RTJ* 


REJINT 


< 


0073 


P0056 


5812 




RTJ* 


REJEXT 


Ready? 




0074 


P0057 


18F9 




JMP* 


A14 






0075 


P0058 


0FCC 


A44 


ALS 


12 






0076 


P0059 


0131 




SAM 


* + 2 






0077 
0078 


P005A 


18F6 




JMP* 


A14 






P005B 


0DFE 




INQ 


-1 






0079 


P005C 


0A00 




ENA 









0080 


P005D 


0207 




INP 


7 






0081 


P005E 


6900 




STA 


DATA*200»I 


Input 


< 




P005F 


00E2 








Data 


0082 


P0060 


00FF 




RAO- 


I 






0083 


P0061 


C0FF 




LDA- 


I 






0084 


P0062 


0104 




SAZ 


A16-*-l 






0085 


P0063 


18ED 




JMP* 


A14 






0086 


P0064 


580C 




RTJ* 


REJINT 






0087 


P0065 


5803 




RTJ* 


REJEXT 






^ 0088 


P0066 


18EA 




JMP* 


A14 






^ 0089 


P0067 


0000 


A16 


SLS 








0090 


P0068 


0000 


REJEXT 








External 


J 


0091 


P0069 


EOOO 




LDQ 


*N$1381 


Reject 


< 




P006A 


1381 












0092 


P006B 


0B00 




NOP 








^ 0093 


P006C 


02FE 




INP 


-1 



BACKSPACE 



DIR STATUS 1 



BUSY? 

SKIP WHEN NOT BUSY 

SEL READ MOTION 



STATUS 



WAIT FOR DATA READY 



INPUT DATA 



STORE DATA NOT 
ASSEMBLED 



STOP WHEN THROUGH 

EXT REJ 

TAKE STATUS 
AND STOP 
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0094 


P006D 


E8FA 


0095 


P006E 


0000 


0096 


P006F 


1CF8 


0097 


P0070 


0000 


0098 


P0071 


E000 




P0072 


1381 


0099 


P0073 


OBOO 


0100 


P0074 


02FE 


0101 


P0075 


E8FA 


0102 


P0076 


D8F9 


0103 


P0077 


0000 


0104 


P0078 


1CF7 


0105 


P0079 


00C8 


0106 







REJINT 



LDQ* 


REJEXT 


SLS 





JMP* 


(REJEXT) 








LDQ 


*N$1381 


NOP 




INP 


-1 


LDQ* 


REJINT 


RAO* 


REJINT 


SLS 





JMP* 


(REJINT) 


BZS 


DATA(200) 


END 





RUN TO RETURN 

INTERNAL REJECT 

TAKE STATUS 

AND STOP 

RUN TO RETURN 



DATA BLOCK 



o 



Lockheed - September 1968 
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12.10 

12.10 1732/608-609 MAGNETIC TAPE 

The 1732 controller for 608 and 609 Magnetic tapes is very similar to the 1731 and can 
be programmed in identically the same way as the 1731. For that reason, a separate 
program for the 1732 is not included here. Instead, the 1731 program was run on the 
1732/608. 

The 1732 provides an additional feature which was not available on the 1731: option for 
selecting assembly /disassembly mode. This means that two frames at a time can be 
sent to or received from the controller in one OUT or INP (consequently meaning the 
controller has to be accessed half as often). The controller takes care of assembling 
or disassembling the frames on the tape. Bit 6 (not used on the 1731) in the function 
code is used to select this mode. 

This is especially useful on the 609 (9- track tape) in that two 8-bit frames exactly fit 
in one 16-bit 1700 word. Repacking the buffer can be eliminated since a word at a 
time is sent to the controller. The 609 uses only 800 BPI density, and normal end of 
files are not used on it. For example: 

• Load 601 MT program from lockheed (or reassemble with changes) 

• Clear 1706 code from all Q addresses - MT's are not on 1706 (i.e. , change $1382 
to $0382) 

• Change P0003 to: 

$4D4 for 608 (adds selection of assembly) 
$4CC for 609 (800 BPI only, assembly) 

• Change P0021 to FFFF 

• Follow operating instructions on 601 program 

• Output from A will be (in assembly/disassembly): 

608 - bits 8-13 and 0-5 

609 - bits 8-15 and 0-7 

• Input to A will be: 

608 
609 



[X X 1 1 1 1 1 1 


XX 1 1 1 1 1 1 


v. „ y 


V 


1 








1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 1 


v J 




J 


"V 


-^ 




00 1 1 1 1 1 1 


00 1 1 1 1 1 1 




1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 1 



• The upper bits in A are the first frame; the lower bits are the second frame. 

12. 11 1706 BUFFER DATA CHANNEL 

The 1706 is a 16-bit, bidirectional, buffer channel with word transfer rates up to 
900 KC (approximately 1. 1 microseconds per 16-bit word). 

The 1706 buffers data between the computer's memory and a peripheral. The 1706 is 
capable of buffering as many as eight devices. The 1700 system may have three 1706's 
attached. 
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The 1706 has no indicators nor control panels, therefore, all operations are initiated 
by the computer viatheA/Q channel. The 1706 is considered as one of the eight devices 
attached to the A/Q channel and the DSA channel with each peripheral connected to the 
1706 being a substation. Consequently, only one of the 1706's peripherals may be 
referenced at a time. 

The program requests direct access to a peripheral via the 1706 to establish the logic. 
Once the logic has been established, the program requests the 1706 to perform the data 
transfer. 

Bits 11-15, the W field, of the Q Register are used to reference the 1706 and to indi- 
cate the desired operation. Bits Or 10 of the Q Register will contain the same bit setting 
used to reference a particular peripheral when it is not attached to the 1706. 



Q 



15 




11 


10 




7 


6 







W 


E 




S 


D 



1706 



Peripheral 



O 



It is possible to perform direct I/O on a device connected to the 1706 simply by setting 
W to 00010 and sending all the codes for the device thru the 1706. (However, normally 
if a device is on the 1706, it is desired to perform data transfers in a buffered mode 
by letting the 1706 perform the operations.) 



O 



12. 11. 1 1706 Functions 

The setting of the W field is dependent upon which of the possible three 1706's the 
program is referencing. There are four settings for each 1706. 







W SETTING* 




COMPUTER OPERATION 




1706 

#3 


1706 

#2 


1706 

#1 


INP 


OUT 


1. 


oC 


o7 


2 


Direct Input 


Direct Output 


2. 


oD 


08 


3 


Terminate Buffer: 
Current Addr of 1706 


Function 


3. 


oE 


o9 


o4 


1706 Status 


Buffered Output 


4. 


oF 


oA 


o5 


1706 Current Addr 


Buffered Input 



*The left digit is binary, the right digit is hexadecimal. 
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The first W setting provides the computer direct access to the peripheral. The 
peripheral may be requested to send to the A Register a data word or status word. 
The computer may send to the peripheral a function or data word from the A Reg- 
ister. This mode of operation is identical in every way to that on the A/Q channel. 

12. 11. 2 Programming the Peripheral Through the 1706 



The 609 magnetic tape unit shall be used as an example with 1706 number 1. It is 
necessary to set up the equipment prior to telling the 1706 to do any I/O on the 
equipment. 



LDQ 


=N$1202 


DIRECT OUT 


LDA 


=N$4CC 


SEL UNIT 1, ASSEMBLY, 
800 BPI, BIN 



NOP 
OUT 



-1 



INQ 


-1 


LDA 


=N$80 


NOP 





PREPARE FOR TAPE MOTION 
WRITE MOTION 



OUT 



-1 



The 609 tape unit has now been functioned. The next step is to function the 1706, 
requesting it to interrupt the computer when the data transfer is complete. (This 
is if the 1706 will be operated in interrupt mode. ) 



LDQ 
LDA 
NOP 
OUT 



=N$1800 
=N$8001 



-1 



1706 FOR FUNCTION #3 
INT ON EOP 



1706 IS FUNCTIONED 



The 1706 and the peripheral have both been functioned. The next step is to initiate 
the I/O operation. At this point the 1706 will take over and do the data transfer. 
It will now be impossible to directly access the peripheral until the 1706 is finished 
or becomes hung up. 

The 1706 expects to find the First Word Address minus one (FWA-1) of the buffer 
area in the A Register when the I/O operation is initiated. Upon receiving the 
FWA-1 the 1706 goes into the computer's memory and extracts the Last Word Ad- 
dress plus one (LWA+1) from that location. The 1706 then updates the FWA-1 by 
1 until it equals the LWA+1 at which point the data transfer is complete. 
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o 



LDA 


=XLWA+1 


LAST WORD ADDR + 1 IN A 


STA 


FWA-1 


LWA=1 AT FWA-1 


LDQ 


=N$2200 


BUFFER OUT. EQUIP #4 


LDA 


=XFWA-1 


FWA-1 IN A 


NOP 






OUT 


-1 


OPERATION INITIATED 



The program at this point may exit 
Two other alternatives are available: 
current address. 



and wait for the End of Operation interrupt, 
status for End of Operation or status for 



STAT 



CMP 



STADR 



LDQ 


=N$2200 


STATUS 1706 


NOP 






INP 


-1 


STATUS IN A 


ALS 


11 


EOP BIT AT SIGN BIT 


SAM 


CMP 


WHEN SET OP COMPLETE 


JMP* 


STAT 


WAIT UNTIL COMPLETE 


LDQ 


=N$2A00 


CURRENT ADDR, EQUIP 4 


NOP 






INP 


-1 


CURRENT ADDR IN A 


SUB 


=XLWA+1 


SUBT LWA+1 


SAZ 


CMP1 


ZERO, OPERATION CMP 


JMP* 


STADR 


CONTINUE STATUS FOR A] 



CMP1 



o 



12.11.3 1706 Status 

Once the data transfer is complete, the program may process the data. The pro- 
gram may at any time status the 1706 for the current address and for the 1706 
status word. The program may check the status word for the following information. 



15 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 













[•;•;•;•;• 












1 


1 










[.•.■.•.". 














1 


'.".*.■.•.*.'-•.•.*.*."-"-•.*.•. 








i*. ■.".•.• 




■. •.•••.■.■ 








1 


l 



i t 



Device Reply 
Device Reset 
Program Protect Fault 



EOP 



t t ♦ 

| Ready 

Busy 

Interrupt 
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Note that this is the status of the 1706, not the peripheral. It is not possible to 
get the status of the peripheral while the 1706 is working on it. 



Ready (Bit = 1) 
Busy (Bit 1 = 1) 



Interrupt (Bit 2 = 1) 



Program protect fault (Bit 6=1) 



Device Reject (Bit 8 = 1) 



Device Reply (Bit 9 = 1) 



This bit is set when power is on. 

This bit is set from the time the 1706 accepts 
an output word from the computer initiating a 
block transfer until the block transfer is ter- 
minated, or during a direct operation. 

A buffer transfer input or output has been com- 
pleted. 

A reference to computer storage caused a pro- 
gram protect fault. 

This bit, if set, means the peripheral device 
rejected the last word transfer attempted from 
the 1706. 



-+ This bit, if set, means the peripheral device 
accepted the last word transfer attempted from 
the 1706. 



It is possible for the 1706 to get hung up as it continually repeats an attempt to 
make a data transfer to the peripheral if the peripheral fails. 

The program may status and find a Device Reject status. If this condition were to 
arise, the program may terminate the buffer operation. This termination is 
always necessary when the buffer becomes hung up. When the operation is ter- 
minated, the current address is sent to the A Register automatically. 



LDQ 
NOP 
INP 



=N$1A00 
-1 



TERMINATE BUFFER, EQUIP 4 
CURRENT ADDR IN A 



12. 11. 4 Summary of 1706 

In summary, the computer functions the peripheral direct via the 1706. Once the 
peripheral is functioned, the End of Operation interrupt is requested. The program 
must have the LWA+1 at the FWA-1 prior to initiating a buffer operation. When 
the buffer operation is initiated, the FWA-1 is in the A Register and sent to the 1706. 
The status word of the 1706 may be requested anytime as well as the current ad- 
dress. The program cannot status the peripheral itself until the operation is 
completed or terminated. 
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12.11.5 
12.11.5 1706 Example Program 



Example: 

The following is a test program for a 609 magnetic tape on a 1732 controller, op- 
erated in buffered mode by the 1706. The program outputs 50 words of data from 
the buffer beginning at BUF+1, rewinds the tape, and reads the data back in. 

The buffer should be set to all one bits from the console. Then the program should 
be operated with the STOP switch set so that the program will stop after writing 
(to allow the programmer to clear the buffer from the console) . After reading, 
it will stop again where the buffer can be swept to see the data. 



O 
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01 
0002 
0003 



1000 



NAM 
ENT 
-F-OU- 



MT609 

MT 
QUTObCBlOOO) 



DIRECT OUT 



0004 
0005 



18u0 
20 



EQU 
-&OU- 



FUN06<$1800) FUNCTION 
BUF06CR2000) BUFFER OUT OR STATUS 



0006 
0007 



280 
0280 



EOU 
-E-OU- 



BUFIN($2800) 
EQUIP(S280) 



0008 
000O 



BUFFER IN 
1732 EQUIP # 4 



"SET BUFFER TO ONE * S FROM CONSOL E- 



0010 
0011 



"SET STOP SWITCH 



0012 
0013 



P0 000 EQOO 



40- 



LDQ 



= XQUT06 + EQUIP+-1 DIRECT OUT 



ooia 



■P0001 
P0002 



1281 
A 01 



-£NA- 



CLR CONTROLLER 



0015 
0016 



P0003 
PQ0Q4 



03FE 
EQUO 



OUT 
-WOO- 



-1 

=XOUT0fitEQUIPt2 DIRECT OUT 



0017 



P0005 
POO 6 



1282 
C000 



LDA 



stmCC 



0018 



P0007 
P0008 



04CC 
OBOQ 



SEL UNIT 1, ASSEMBLY. 



MOP 



800 bpi, BINARY 



0019 
0020 



P0009 
P000A 



03FE 
ODFE 



OUT 
-W4Q- 



0021 



POO OB 
POQOC 



C000 
0080 



LDA 



=N$80 



WRITE MOTION 



0022 
0023 



P000D 
P000E 



0800 
03FE 



NOP 
-9W- 



—4- 



0024 
0025 



0026 
0027 



HERE IS WHERE NORMALLY WE 
WOULD SEL EOP INT AND 



P000F EQOO 



-LOO- 



OUTPUT IT 
sXBUF06 + E QUIP BUFFER OUT 



0028 



P0010 
P0011 



2280 
C000 



-LOA- 



= XBUF 



FWA - 1 



0029 



P0012 
PQ013 



002C 
0B0 



440R- 



0030 
0031 



P0014 
P0015 



03FE 
0B0 



STAT 



OUT 

NOP 



0032 
0033 



P0016 
P00I7 



02FE 
OFCB 



INP 
ALS 



INPUT STATUS 
WAIT FOR EOP 



0034 
0035 



P0018 
P0Q19 



0131 

1MFB 



SAM 
JMP» 



» + 2 
STAT 



EOP IMPLIES GOOD PARITY 



0036 
0037 



P001A 
POO IB 



00U0 
EQOO 



SLS 
LDQ 




~XOUT06+EQUIP+1 



CLEAR BUF FROM CONSOLE 
DIRECT OUT 



0038 



P001C 
POO ID 



1281 

COOP 



LDA 



=N'K400 



REWIND TAPE 



0039 



P001E 
POOIF 



0400 

nmio 
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13.0 INTRODUCTION 



The preceding chapter, Peripheral Programming I, discussed in detail the procedures 
for programming the standard 1700 peripherals. Inefficiency would result if each user 
program were required to contain the coding necessary to drive a peripheral; therefore, 
the operating system contains programs that perform all input/ output operations. 
These programs are referred to as drivers. 

Drivers are divided into three main parts: initiator, continuator and error. 

13. 1 INITIATOR SECTION OF DRIVER 

The initiator portion sets up the logic to be used and initiates the operations to be per- 
formed. The paper tape reader shall be used as an example. All of the drivers are 
written in interrupt mode. Interrupt mode allows the driver to initiate an operation and 
select interrupts, exit to the operating system and regain control when the peripheral 
has completed the operation. 



O 



LDQ 


=N$A1 


ENA 


1 


OUT 


-1 


ENA 


$34 


OUT 


-1 



SEL PTR, FUNC 
CLR CONTROLLER 

START MOTION, SEL INT ON 
ALARM OR DATA 
EXIT TO OPERATING SYSTEM 

Via the above coding, the initiator portion of the paper tape reader has selected the 
equipment, selected interrupts, and exited to wait for an interrupt. The initiator 
portion of every driver initiates these three operations. 

13. 2 INTERRUPT FROM EQUIPMENT 

The equipment will generate an interrupt when a selected interrupt condition arises. 
The acknowledgement of interrupt is on a priority basis. The priority depends on the 
setting of the 16 -bit mask register. A maximum of 16 interrupt lines may be connected 
to the 1700, with each line corresponding to a bit in the mask register. 
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The bit in the corresponding bit position must be a 1 in order for the interrupt to be 
acknowledged. If the bit is a 0, the interrupt holds and is not acknowledged until the bit 
becomes a 1. 

Once the bit is set to a 1 in the M register, control is transferred to the interrupt trap 
region. The trap region is set up to allow four words for each interrupt line. The core 
locations are always from location lOO^g to 13F^g. See section 1. 3 to review the in- 
terrupt system. 



13F 
13E 
13D 
13C 



LINE 15 



LINE 1 



LINE 



Interrupts may be nested 16 deep! 



Four core locations reserved for each 
interrupt line: 

- word 4 - address of interrupt processor 

- word 3 - priority level for line 

- word 2 - RT J to interrupt handler 

- word 1 - overflow and P 



Figure 34. 1700 Interrupt Hardware and Software Functions 

Hardware: 

• Disables interrupts 

• Stores overflow indicator and P of interrupted program in word 1 

• Transfers control to word 2 
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Software: 

• Word 2 contains RT J to common interrupt handler 

• Interrupt handler saves registers of interrupted program, sets new mask from 
priority level in word 3, enables interrupts, and transfers control to interrupt 
processor for that line (from address in word 4). 

• Interrupt processor must exit to the driver continuator which will service the 
equipment (i. e. , input data). 

• The continuator must exit through the dispatcher to restore the interrupted program. 

The computer hardware disables interrupts and stores the contents of the P register 
in the lower 15 bits of the first trap word for the interrupting line. The hardware sets 
the upper bit of the first word to a 1 if the overflow indicator is on and to a if the 
indicator is off. Control is then passed to the second word. 

Once control is passed to the second word, the processing is under software control. 
See Figure 36 for hardware and software functions. 

13. 3 COMMON INTERRUPT HANDLER 

The second word contains a return jump to the common interrupt handler. The common 
interrupt handler saves the contents of all the pertinent registers: A, Q, M, and I. 
The M register is set to the priority for the interrupting line by using the priority level 
set in the third word. Interrupts are then enabled by the common interrupt handler. 
The interrupt handler transfers control indirectly through the fourth word to the pro- 
cessor for that line. 

13. 4 INTERRUPT LINE PROCESSOR 

The processor for the interrupt line (LYNEI or EPROC) takes status on all equipment 
on the interrupting line and checks bit 2 of each status word. 

The processor will be able to determine which peripheral interrupted because the in- 
terrupt bit (bit 2) of the status word will be set. The interrupt processor will pass 
control to the appropriate continuator portion of a driver. 

13. 5 CONTINUATOR SECTION OF DRIVER 

The continuator checks the alarm bit to determine if control should be passed to the 
error portion of the driver. 
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LDQ 


=N$A1 


SEL PTR, STATUS 


NOP 






INP 


-1 


STATUS IN A 


STA 


STATUS 


SAVE STATUS 


AND 


=N$20 


CK FOR ALARM 


SAZ 


1 


IF ZERO CONTINUE 


JMP 


ERR 


IF NOT ZERO ALARM 



If the alarm bit were not set the interrupting condition would be processed by the con- 
tinuator. The continuator checks further to determine which interrupt was generated. 
The paper tape reader allows the selection of only two interrupts, alarm and data; 
therefore, if the alarm bit was not set the data interrupt was probably generated. It 
would be wise to check the data interrupt bit and if it is not set, pass control to GI 
(ghost interrupt) in the error section: 



Input data if the data bit was set: 



DATA 



LDA 


STATUS 




AND 


=N8 




SAN 


DATA 




JMP 


GI 




nsls set: 






LDQ 


=N$AO 


SEL PTR, DATA 


NOP 






INP 


-1 


DATA IN A 



The continuator then performs the necessary packing operations to form one 16-bit 
word. A check is made to determine if all data has been processed. If not, the con- 
tinuator exits to wait for the next interrupt. 



LDQ =N$A1 

ENA $14 

OUT -1 

EXIT TO OPERATING SYSTEM 



SEL PTR, FUNC 

INT ON DATA OR ALARM 



The continuator could simply exit without reselecting interrupts because the interrupt 
request is still up if it has not been cleared. 

13. 6 ERROR SECTION OF DRIVER 

The ERROR portion takes status to determine which alarm condition has arisen. Thel 
error routine then performs the necessary operation to correct the error. If the error 
cannot be corrected without operator intervention, the operator should be notified. 
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LDQ 


=N$A1 


NOP 




INP 


-1 


ALS 


5 


SAM 


POWOFF 


ALS 


1 


SAP 


PMF 


ALS 


3 


SAM 


LOSTD 


JMP 


GI 



SEL PTR, STATUS 

STATUS IN A 
POWER ON BIT AT 15 

PAPER MOTION FAIL BIT AT 15 

LOST DATA BIT AT 15 

IF HERE NO ALARM OCCURRED 

The above coding establishes the condition at fault. The skip address sends control to 
routines that process the various errors. 

GI is where control is passed for a ghost interrupt. The equipment interrupted but ap- 
parently for no reason. This would indicate a hardware malfunction. 

13.7 SUMMARY 

The driver can be summarized as follows. The initiator is the first to have control. It 
selects the equipment and selects interrupts, then it exits to the operating system. 
The continuator gains control via the interrupt trap area after the peripheral generates 
an interrupt. It checks for alarm and if one is present, sends control to the error 
portion. If no error occurred, it maintains control and processes the interrupt. If the 
operation is not complete the continuator exits to the operating system. The error por- 
tion determines which alarm condition occurred and attempts to correct the fault and/or 
notifies the operator. Figure 35 illustrates the flow of the interrupts through the con- 
tinuator. 

It is important to note that the primary purpose of this chapter is to illustrate tech- 
niques for programming the hardware in interrupt mode. The linkage through MSOS 
routines is secondary. 

The logical division of programming functions into initiator, continuator, and error 
sections could be utilized to program any peripheral, either in a stand-alone system or 
under MSOS. The operations to be included in each section are the important consid- 
eration here — what the equipment is capable of doing, its timing, and the status of 
responses it can send. At this point the programmer should be able to write an in- 
ter rupt-mode driver which would not run under MSOS. 

To actually write a driver to run under MSOS, it would be necessary to study all the 
linkage to MSOS since system tables and common subroutines are used by all the MSOS 
drivers. 

Some of the MSOS routines are included at the end of this chapter for illustration. 
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Example 

The following is a test program to print a message on the teletype in interrupt mode. It 
uses the MSOS Interrupt Handler to save the state of the interrupted program (probably 
the idle loop) each time the interrupt comes in. It bypas s e s the Line 1 Interrupt Pro- 
cessor (interrupt response routine) and MSOS driver by storing its own address in the 
fourth word of the interrupt trap for Line 1 (location $107). 

After the program has been assembled and loaded under MSOS, the computer should be 
stopped, the protect switch turned off, and P set to the address TTYI; then it should be 
run. A master clear should not be done because that would disable the interrupt system 
and clear M. 

hi reality, if a program such as this were used in a stand alone system, it would assure 
that bit 1 was set in the M register and execute an EIN. It would also have a routine cor- 
responding to the interrupt handler to save the state of an interrupted program. 

The test routine here simulates the operations on the equipment which would logically be 
performed by different portions of a driver. 

1. TTYI sets up the trap. 

2. INIT is the initiator to set up the equipment. It then exits and waits for the first in- 
terrupt. 

3. CONT is the continuator and it outputs a character each time the interrupt comes in. 
It also must keep track of the number of words desired to be written. It hangs at 
CMPLET when finished. An MSOS driver would schedule the programmer's com- 
pletion address when his request was finished. 

4. ERR. The error section analyzes errors. It hangs in the test routine on each 
error, but in MSOS it would attempt to correct the error. 

5. The TABLES used by the routine contain information which is used by the driver for 
the write; they simulate a physical device table. 

6. INTRES. The interrupt response routine is actually not a part of the driver. It must 
status each device on the line to see which one interrupted. Our example only checks 
the TTY. 
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TTY INTERRUPT MODE 
>PAM UNDER MSOS - TURN OFF PROTECT SWITCH 
: - DO NOT MASTER CLEAR - SET P AND RUN 

ADlSP(iEA) 

TTY1»C0NT»ERR*INTRES 



=XINTRES SUBST1TUET INTRES IN TRAP 

$107 



INITIATOR 
TTY GET TTY FUNC CODE 

3 CLR CONTROL CLR INTERRUPT 

-1 
=N$100 SELECT WRITE MODE 



-1 

-1 CHANGE TO DATA FUNCTION 

-1 OUTPUT DUMMY CHARACTER 

1 SEND FUNCTION 

$14 SEL INTERRUPT ALARM OR DAT/ 

-1 

(ADISP) GO WAIT FOR INT 

CONTINUATOR 

STAT GET STATUS BACK 

10 CK ALARM BIT 5 
OK-tf-1 

ERR ALARM UP 

2 CK DATA BIT 3 
DATA 

GI NOT ALARM OR DATA 

(FWA) GET DATA 

FLAG GET CHAR FLAG 

LOWER 

8 UPPER CHAR 



FLAG CLR FLAG FOR LOWER NEXT 

OUTPUT GO OUTPUT DATA 

FLAG SET FLAG FOR UPPER NEXT 

FWA UPDATE BUFFER ADDR 

TTY 

-1 DATA FUNC 

-1 OUTPUT 1 CHAR 

FWA LAST WORD YET 

LWA 

CMPLET 

(ADISP) GO AWAIT NEXT INT 

$18FF HANG WHEN FINIShED 
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ERROR SECTION 

FIND CAUSE OF ERROR 

CK MOTOR ONN 

MOTOR OFF - HANG HERE 
CK LOST DATA 

LOST DATA - HANG HERE 
NO ERROR APPARENT... 

TABLES (PHYSTB) 
USED BY DRIVER 

TTY FUNC CODE 

CURRENT BUFFER ADDRESS 

LWA + 1 

STATUS WORD 



INTERRUPT RESPONSE 
NOl PART OF DRIVER 

STATUS TTY 

SAVE IT 

CK INTERRUPT BIT 

GO TO TTY CONT1NUATOR 
GHOST INTERRUPT HANG HERE 



35, THIS MESSAGE IS WRITTEN IN INTERRUPT 
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Figure 35. Interrupt Flow 
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13. 8 The following is an example of one of the ADSD bulletins, illustrating interrupt pro- 
cessing routines. 
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INTERRUPT PROCESSING ROUTINES 

This Information Bulletin briefly describes the software involved in processing an interrupt. 
Although interrupt processing is not new, it is often misunderstood. An Interrupt Service 
Routine varies in complexity depending on the hardware constraints and user requirements. 
The Interrupt Service Routine used in the CONTROL DATA 1700 Computer Operating System 
is not a "closed" routine; rather, it is a group of subroutines which are linked together to 
provide the flexibility required by today's state-of-the-art programming techniques. 

The following conditions must be met in the CDC 1700 Computer before an interrupt can be 
detected. 



The interrupt system must be enabled. 

An interrupt line must be true. 

The corresponding bit in the interrupt Mask register (M) must be set. 



In the following discussion, it has been assumed that the above conditions have been met and 
that the interrupt is detected or trapped. When an interrupt is trapped, the program sequence 
is interrupted (or suspended), the address of the instruction to have been executed next is 
saved, the interrupt system is disabled, and control is transferred to the Interrupt Trap Region. 

INTERRUPT TRAP REGION 

The Interrupt Trap Region is a dedicated area of memory from location lOO^g through location 
13Fjg (64 locations). Four consecutive locations in this region are assigned to each interrupt 
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line. Since there are 16 interrupt lines with 4 memory cells for each line, there are 64 loca- 
tions assigned to the Interrupt Trap Region. The first four locations are for interrupt line 
"0, " the next four are for interrupt line "1, " and so on. When an interrupt is trapped, control 
is transferred to the second location of the group that is associated with the interrupt line. The 
exact location is computed as 

LOC. 100 16 + 4 16 (LINE NO.) + 1. 

The four memory locations for each interrupt line are shown below followed by an explanation 
of the contents of each word. (Words are labeled A, B, C and D.) 



INTERRUPT 
LINE NO. 
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8 
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10 
11 
12 
13 

14 

15 



{ 
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ADDRESS 
BASE 16 
100— 



{ 



{ 



103— 
104 

107 
108 
10C 

110 

114 
115 
116 
117 

118 
11C 
120 
124 
128 
12C 
130 
134 

138 
13C 

13F 



15 



114 



115, 



116 

117 



A 
B 

C 
D 



A = When an interrupt is trapped, the address of the instruction to have been executed next 
is saved in A14 - Ao. A15 will contain the Overflow flip-flop's status when the interrupt 
was trapped. Loading this memory location as described above is accomplished automa- 
tically by the hardware. 
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B = This location normally contains a one -word indirect Return Jump instruction to a routine 
that is responsible for preserving the state of the computer's registers (A, Q, I), con- 
tents of location "A" and the interrupted programs priority level. In most cases, this 
Return Jump is to the Common Interrupt Handler. The exact parameters for this word 
are decided when building the Operating System. 

C = This location contains the software priority level associated with this interrupt line. 

Note that only one priority level can be associated with a given interrupt line; however, 
any number of interrupt lines, up to 16, can be assigned the same software priority 
level. The exact parameters for this word are decided when building the Operating 
System. (See Note 2.) 

D = This last location of the four -word group contains the absolute address of the Interrupt 
Response Routine for this interrupt line. 

From the above descriptions it can be seen that the "A" parameter is loaded automatically by 
the hardware and that control is transferred to the "B" parameter (Return Jump). It is assumed 
in this discussion that the Return Jump instruction passes control to the Common Interrupt 
Handler. See Note 1. 

COMMON INTERRUPT HANDLER 

The Common Interrupt Handler saves the state of the computer (interrupted program) in the 
Interrupt Stack Region. Information saved includes the contents of the A-, Q-, I-, and P- 
registers, the Overflow status, and the software priority of the interrupted program. The 
Common Interrupt Handler then sets the new software priority level, sets the M-register for 
the new software priority level, enables the interrupt system, and transfers control to the 
address specified by the "D" parameter, the absolute address of the Interrupt Response 
Routine. 

INTERRUPT RESPONSE ROUTINE 

The Interrupt Response Routine is usually a small, user-written subroutine to determine which 
device caused the interrupt if there is more than one device on the interrupt line and transfer 
control to the "driver" entry point to process the interrupt. 

DRIVERS 

The Driver acknowledges (clears) the interrupt line and processes the data as required. Even- 
tually, upon completion of the program initiated by the interrupt, the Driver passes control to a 
module which is responsible for returning the computer to the original state of the secured pro- 
gram. In the CDC 1700 Computer Monitor, this module is called the Dispatcher. 

DISPATCHER 

The Dispatcher returns the computer to its original state (its condition at the time of the 
interrupt) by reloading the A-, Q-, I-, and P-registers, Overflow Status, and priority 
levels from the Interrupt Stack Region and transfers control back to the address stored as 
parameter "A" in the Interrupt Trap Region. The M-register is also restored. 
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FROM INTERRUPTED 
PROGRAM 



INTERRUPT 
TRAP 



COMMON 

INTERRUPT 

HANDLER 



INTERRUPT 

RESPONSE 

ROUTINE 



DRIVER 



RETURN TO INTERRUPTED PROGRAM ^- 



V.. 



DISPATCHER 



SPECIAL NOTES 

Note 1 

A software rule exists which states that interrupts will not be inhibited for more than 45 mem- 
ory cycles (50 /xs). If an interrupt can be processed in less than 50 /xs, the Common Interrupt 
Handler and the Dispatcher may be bypassed. Therefore, in such cases, parameters "C M and 
"D" in the Interrupt Trap Region will not be necessary. The one-word indirect Return Jump 
in location B will transfer control directly to the Interrupt Response Routine or Driver. 

Note 2 

Interrupt priorities 

1. Hardware priorities are from the lower numbered interrupt lines, to the higher numbered 
interrupt lines. The lower numbered lines being recognized first by the hardware. 

2. Software priorities are not necessarily associated with interrupt line numbers, the higher 
software priority numbers are processed first. For example, a program running at soft- 
ware priority level 5, requests a driver that has a software priority level of 10. The 
running program would be interrupted and the driver would be initiated (software interrupt) . 

As an example of how the hardware and software priorities work together assume the following: 

1. Processing is being accomplished by the Monitor with interrupts disabled. 

2. When the interrupt system is enabled there are two hardware interrupts ready for 
processing interrupt line-1 (common synchronizer), and software priority level 10, and 
interrupt line-2 (the timer) software priority level 13. 

When the interrupt system is enabled the hardware control will trap the interrupt from line-1 
(higher priority, lower line number and disable the interrupt system) . This interrupt will be 
processed through the Common Interrupt Handler requiring about 50 microseconds. The Com- 
mon Interrupt Handler sets the new software priority level (M-Register Mask), enables interrupts, 
and transfers control to the Interrupt Response Routine. Interrupt line-2 will trap. This is 
allowed by the mask setting in the "M" register. The software priority of the "Timer" is always 
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higher than the common synchronizer and must be processed first. However, this could not 
have been determined prior to the interrupt response routine. Line -2 will continue being 
processed until completion or until it itself is interrupted. 

Therefore, even though the hardware indicated that interrupt line-1 had priority, the software 
dictated that interrupt line -2 actually had a higher priority. 
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13. 9 The following is a listing of the interrupt handler. 



001. 
003. 



NAM COMMON INTERRUPT HANDLER 
PART NO. E00610A0010S 



005. 








ENT 


ALLIN 




006. 




00B8 




EQU 


COUNT ($B8) 




007. 




OOEF 




EQU 


PRLVL($EF) 




008. 




00B7 




EQU 


AMASKT($B7) 




009. 




0022 




EQU 


ZERO($22) 




010. 






* 








011. 






* 


AFTER CONTROL IS TRANSFERRED FROM THE INTERRUPT 


012. 






* 


TRAP LOCATION TO THE COMMON INTERRUPT HANDLER, 


013. 






* 


THE RETURN LOCATION, A, 


Q AND I REGISTERS AND 


014. 






* 


PRIORITY ARE SAVED IN A PUSH-UP POP-DOWN STACK 


015. 






* 


BY PRIORITY LEVEL. THEN THE NEW PRIORITY AND 


016. 






* 


MASK ARE SET AND CONTROL IS TRANSFERRED TO THE 


017. 






* 


ADDRESS ASSOCIATED WITH THE LINE ON WHICH THE 


018. 






* 


INTERRUPT APPEARED. 




019. 






* 








020. 




0000 




EQU 


XQ(0),XA, (1),XI(2),XR(3),XPL(4),XL(5) 






0001 














0002 














0003 














0004 














0005 










021. 


P0000 


0000 


ALLIN 








LINK TO LEVEL ENTRY 


022. 


P0001 


44BB 




STQ- 


(COUNT) 


SAVE Q IN STACK 


023. 


P0002 


E0B8 




LDQ- 


COUNT 


STACK COUNTER AS INDEX 


024. 


P0003 


6201 




STA- 


XA,Q 


SAVE A 


025. 


P0004 


COEF 




LDA- 


PRLVL 


SAVE PRIORITY 


026. 


P0005 


6204 




STA- 


XPL,Q 




027. 


P0006 


COFF 




LDA- 


I 


SAVE MEMORY 


028. 


P0007 


6202 




STA- 


XI, Q 


INDEX REGISTER 


029. 


P0008 


40FF 




STQ- 


I 


STACK LOCATION BASE 


030. 


P0009 


0D05 




INQ 


XL 


UPDATE STACK 


031. 


P000A 40B8 




STQ- 


COUNT 




032. 


P000B E8F4 




LDQ* 


ALLIN 


LEVEL LINK 


033. 


P000C 


ODFD 




INQ 


-2 


ADJUST TRAP LOCATION 


034. 


P000D 


C622 




LDA- 


(ZERO),Q 


RETURN LOCATION 


035. 


P000E 


6103 




STA- 


XR,I 




036. 


P000F 


40FF 




STQ- 


I 


SAVE TRAP LOCATION IN I 


037. 


P0010 


E202 




LDQ- 


2,Q 


SET NEW 


038. 


POOH 


40EF 




STQ- 


PRLVL 


PRIORITY LEVEL 


039. 


P0012 


C6B7 




LDA- 


(AMASKT),Q 


SET NEW MASK I M REGISTER 


040. 


P0013 


0400 




EIN 






041. 


P0014 


0821 




TRA 


M 




042. 


P0015 


El03 




LDQ- 


3,1 


JUMP TO PROCESSOR 


043. 


P0016 


1622 




JMP- 


(ZERO),Q 


LOCATION IN Q 


044. 








END 






I 


OOFF ALLIN 0000P 


COUNT 00BB PRLVL 


OOEF AMASKT 00B7 


ZERO 0022 XQ 


0000 


XA 


0001 XI 


0002 XR 0003 


XPL 


0004 XL 


0005 
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13. 10 The following is a listing of the dispatcher 



001. 

003. 

005. 
006. 
007. 
008. 
009. 
010. 

on. 



012. 
013. 



O 



o 



014. 
015. 



016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 



00B8 

00EF 

00B7 

0104 

0002 

0012 

0022 

0023 

0033 

0009 

0000 

0001 

0002 

0003 

0004 

0005 

00B4 

0001 

0002 

0003 



P0000 
P0001 
P0002 
P0003 
P0004 
P0005 
P0006 
P0007 
P0008 
P0009 
P000A 
P000B 
P000C 



POOOD 
POOOE 
POOOF 
P0010 
POOH 
P0012 
P0013 
P0014 



FFFF 

E0B8 

ODFA 

0500 

C8FB 

0900 

0106 

CCF8 

A006 

0821 

9204 

0101 

012C 



C203 
6C2B 
C202 
60FF 
C201 
40B8 
E204 
40EF 



NAM DISPATCHER 

PART NO. E00610A0020S 



ENT 
EXT 
EQU 
EQU 
EQU 
EQU 
EQU 



EQU 
EQU 



DISP, SCHTOP 

SCHSTK, SCHLNG 

CONT($B8) 

PRLVL($EF) 

AMASKT($B7) 

COMEXT($104) 

LPMSK($2), NZERO($12), ZERO($22), ONEBIT($23), ZROBIT($33) 



RCSCHD(9) 
XQ(0),XA(1),XI(2),XR(3),XPL(4),XL(5) 



EQU 

EQU 



TOMPT($B4) 
PC(1),PT(2),PQ(3) 



UPON COMPLETION OF A PROGRAM, THE DISPATCHER 
DETERMINES THE PROGRAM OF HIGHEST PRIORITY 

WAITTNG FOR EXECUTION. IT MAY EITHER BE IN THE 
INTERRUPT STACK OR THE SCHEDULER STACK. 



SCHTOP 
DISP 



NUM 

LDQ- 

INQ 

UN 

LDA* 

INA 

SAZ 

LDA* 

AND- 

TRA 

SUB- 

SAZ 

SAP 



$FFFF 

CONT 

-XL 



SCHTOP 



RESlNT-*-l 

(SCHTOP) 

LPMSK+4 

M 

XPL,Q 

RESINT-*-l 

SCHSTC-*-! 



SCHEDULE STACK TOP 

ADJUST STACK 
IF SCHEDLER STACK IS 

EMPTY, CHECK INT. STACK 

LOAD FIRST WORD 

ISOLATE PRIORITY 

SAVE TEMP. IN M 
PRIORITY OF HIGHEST INT. 
GO TO INTERRUPT STACK 

GO TO SCHEDLE STACK 



HIGHEST PROGRAM IS IN THE INTERRUPT STACK. 



RESINT 



LDA- 
STA* 
LDA- 
STA- 
LDA- 
STQ- 
LDQ- 



XR,Q 

(ACOMEX) 

XI, Q 

I 

XA,Q 

CONT 

XPL,Q 



SET RETRN LOCATION 



RESTORE I 



RESTORE A 
STORE INT. STACK BASE 
RESTORE PRIORITY LEVEL 
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046. 


P0015 


E6B7 






LDQ- 


(AMASKT), Q 


047. 


P0016 


0811 






TRQ 


M 


048. 


P0017 


E4B8 






LDQ- 


(CONT) 


049. 


P0018 


0E04 






EXI 


COMEXT-256 


050. 








* 






051. 








* HIGHEST PROGRAM IS IN THE SCHEI 


052. 








* 






053. 


P0019 


080A 




SCHSTC 


TRM 


Q 


054. 


P001A 


40EF 






STQ- 


PRLVL 


055. 


P001B 


C6B7 






LDA- 


(AMASKT), Q 


056. 


P001C 


0821 






TRA 


M 


057. 


P001D 


E8E2 






LDQ* 


SCHTOP 


058. 


P001E 


C202 






LDA- 


PT,Q 


059. 


P001F 


68E0 






STA* 


SCHTOP 


060. 


P0020 


0814 






TRQ 


A 


061. 


P0021 


9819 






SUB* 


ASCHD 


062. 


P0022 


0138 






SAM 


SCHSEC-*-l 


063. 


P0023 


9818 






SUB* 


ASCLNG 


064. 


P0024 


0126 






SAP 


SCHSEC-*-l 


065. 


P0025 


C0B4 






LDA- 


TOMPT 


066. 


P0026 


6202 






STA- 


PT,Q 


067. 


P0027 


40B4 






STQ- 


TOMPT 


068. 


P0028 


C201 






LDA- 


PC,Q 


069. 


P0029 


6C10 






STA* 


(ACOMEX) 


070. 


P002A 


180C 






JMP* 


SCHXIT 


071. 


P002B 


C622 




SCHSEC 


LDA- 


(ZERO),Q 


072. 


P002C 


A02B 






AND- 


ONEBIT+8 


073. 


P002D 


0101 






SAZ 


SCHl-*-l 


074. 


P002E 


0814 






TRQ 


A 


075. 


P002F 


A011 




SCH1 


. AND- 


LPMASK+15 


076. 


P0030 


8032 






ADD- 


ONEBIT+15 


077. 


P0031 


8201 






ADD- 


PC,Q 


078. 


P0032 


A011 






AND- 


LPMSK+15 


079. 


P0033 


6C06 






STA* 


(ACOMEX) 


080. 


P0034 


0844 






CLR 


A 


081. 


P0035 


6202 






STA- 


PT,Q 


082. 


P0036 


0814 




SCHXIT 


TRQ 


A 


083. 


P0037 


E203 






LDQ- 


PQ,Q 


084. 


P0038 


0E04 






EXI 


COMEXT-256 


085. 


P0039 


0104 




ACOMEX 


ADC 


COMEXT 


086. 


P003A 


7FFF X 


ASCHD 


ADC 


SCHSTK ! 


087. 


P003B 


7FFF X 


ASCLNG 


ADC 


SCHLNG ! 


088. 










END 




I 


OOFF 


DISP 0001P SCHTOP OOOOP CONT 


AMASKT 00B7 


COMEXT 0104 


LPMSK 0002 NZERO 


ONEBIT 0023 


ZROBIT 0033 


RCSCHD 0009 XQ 


XI 


0002 


XR 


0003 


XPL 0004 XL 




0001 


PT 


0002 


: PQ 


0003 RESINT 



RESTORE MASK 
RESTORE Q 



PRIORITY TO Q 

SET NEW PRIORITY AND MASK 



STORE NEW POINTER 

TOP OF SCHEDLER THREAD 

TEST IF PRIMARY SCHEDULER 
CALL WAS MADE. 



IF PRIMARY CALL RELEASE 
STACK POSITION AND PLACE 

ON EMPTY THREAD. 
LOAD ABSOLUTE ADDRESS 

STORE INTO COMEXT 

TEST IF ABSOLTE OR RELATIVE 

CALL. SKIP IF ABSOLUTE 
ADDRESS 1ST WD OF CALL 



ADD REL. ADDRESS OR IF 

A=0, ABS ADDRESS AND STORE 
ZERO INTO THREAD 
COMPLETION INDICATION 
PASS POINTER TO CALL IN A 
PASS, Q 



SCHED. STACK LOCATION 
SCHED. STACK LENGTH LOC. 



00B8 PRLVL 00EF 

0012 ZERO 0022 

0000 XA 0001 

0005 TOMPT 00B4 

000DP SCHSTC 0019P 



SCHSEC 002BP SCH1 



002FP SCHXIT 0036P ACOMEX 0039P ASCHD 



003AP 



ASCLNG 003BP SCHLNG 003BX SCHSTK 003AX 
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CHAPTER XIV - LIBEDT Examples 

TOPIC PAGE 

14. Introduction 14-1 

14. 1 Mass Memory Replace 14-1 

14. 2 GTFILE Request for System Initializer 14-3 
14. 3 Adding Programs and Files to the Program Library 14-5 

14. 4 Transferring Records 14-7 

14. 5 Absolutizing and Linking Subprograms 14-9 



O 



o 



14.0 



14.0 INTRODUCTION 



The MSOS library editing program, LIBEDT, can be used effectively for adding routines 
to the program library, exchanging old routines in the program or system library for 
new ones, and for many utility functions such as transferring records from one logical 
unit to another, absolutizing programs, etc. 

The LIBEDT chapter of the MSOS reference manual describes the features of LIBEDT 
very accurately. Therefore, this chapter will consist simply of examples using 
LIBEDT. 

14. 1 MASS MEMORY REPLACE 

The first example, teletype printout, shows a sample of the checking which could be 
done while replacing a mass memory module in the system library. The replacement 
module is larger than the original one. The comments on the listing are self-explana- 
tory. 
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LIBEDT MASS MEMORY REPLACE 






J 

*LIBEDT 
LIB 

IN 

*DL 

IN 

*DM 
IN 



*M,20, ,M» •* 

*K, 12 -* 

IN 

*M,26,,M -*»- 

L,02 FAILED 02 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

RP 

L,02, FAILED 02 

ACTION 

CU 

E *E 

MI 

*Z 

J 

*p 

J 

*LIBEDT 
LIB 

IN 

*DM -* 

IN 



*Z 

J 
*p 

J 

*L,8 

J 

*SR 

J 

*X„ 

RE 
*M2E6 

RE 
*M2E6rO, 2F1 

RE 
*M2F1,0,2F5 

RE 

*DC0, CI «•- 



Dump program library 

Dump system library 

Cancel this statement with rub-out, LF, CR 
Input on lun 2 PTR 

Replace MM ordinal #26 in system library 
Add and link subroutines from PTR 



Patch missing externals from core resident entry points 



Following checking is only to illustrate debugging features: 



Check to see if ordinal changed (sector address should be larger because new 
program is larger than one it replaces; therefore, it will be put in first avail- 
able scratch sector) 



Dummy L and X to get sys. rec. package 



Dump sector $2E6 (on LP) to check program 



Dump core $C0 and $C1 - scr sector address 



RE 



14-2 



14.2 



14. 2 GTFILE REQUEST FOR SYSTEM INITIALIZER 



This example is not actually a LIBEDT example. However, it is included because it 
pertains to the system initializer. GETSI is a program which can be modified to be 
included in any program library (in relocatable binary form); it can then be called into 
execution in the background by: 

J 

J 

'*si 



The program does a GTFILE r eques t to bring in a file, SYSINI, from the program 
library to address $6000. SYSINI is actually an absolute copy of the system initializer. 
GETSI then jumps to $6000 to execute the system initializer. This is very handy be- 
cause it provides for storing the system initializer on the program library so it can be 
called in without having to key in a bootstrap loader from the console. 
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0001 










NAM 


GETSI 










0002 










ENT 


SI 


0003 


P0000 
POO 01 
POO 02 


5359 
5349 
4E49 




FILNAM 


ALF 


*, SYSINI* «* Name of FILE in program library 


0004 


P0003 
P0004 
P0005 


5349 
2049 
4E20 




BUF 


ALF 


*, SI IN* •+ MSG Buffer for TTY 


0005 




6000 




SIADDR 


EQU 


SIADDR($6000) File to go at $6000 


0006 


P0006 


0000 




SI 








0007 








GETFIL 


GTFILE GOT, (FILNAM), SIADDR, , , 0, O.L 


0007 
0007 
0007 


P0007 
P0008 
P0009 
POOOA 


54F4 
1A01 
0014 
0000 


P 


/ 
Completion address 

after SYSINI is brought 

into core 


\ \ Vvv 01 - 1 

KAA \ \ \ X RP=0 

Address \ \ \ ... . . , 
„ \ X bit = (not blank) 
where Core \ 


0007 


POOOB 
POOOC 
POOOD 


08C2 
0000 
6000 








file name address Disk address 
is where left blank; 
file is program li- 


0007 


POOOE 


0000 








to go brary will be 




POOOF 


8000 


P 






searched 


0008 










EXIT (wait 


for completion) 


0008 


P0010 


54F4 










0008 


P0011 


OAOO 










0009 










EXIT 


(unnecessary) 


0009 


P0012 


54F4 










0009 


P0013 


OAOO 










0010 


P0014 


017B 




GOT 


SQM 


NOGOOD 


0011 








SUN 


FWRITE 


$FC, WROTE, BUF, 3, A, 0, 1, 1, 


0011 
0011 
0011 

0011 
0011 


P0015 
P0016 
P0017 
P0018 
P0019 
POOIA 
POOIB 


54 F4 

0C01 

001E 

0000 

18FC 

0003 

0003 


P 
P 




LUN I U t ik U } f X bit = (not blank) 

(std comment COMPL ^^ Mt referrtn * t0 $F ° 
device) ADDR MgG Rp = " 

BUF ASCII 
3 words 


0012 










EXIT 




0012 


P001C 


54F4 






Wait until Write is done 


0012 


P001D 


OAOO 










0013 


P001E 


0171 




WROTE 


SQM 


NOGOOD 


0014 


P001F 


ICED 






JMP* 


/r'TT'T'TPTT 1 fi\ ^ 


Jump to beginning address of 


^JjrJli 1 J: Yi-rrKt) ^ 


0015 








NOGOOD 


EXIT 


SYSINI which is $6000 


0015 


P0020 


54F4 










0015 


P0021 


OAOO 










0016 










END 


SI 











c 



This program may be reassembled for any system. Change EQU for the desired high 
core address where the system initializer should run when in core. The system initial- 
izer should be stored in the program library under the file name SYSINI, as an absolute 
file. 



14-4 



14.3 



14. 3 ADDING PROGRAMS AND FILES TO THE PROGRAM LIBRARY 



The following example shows the use of LIBEDT to absolutize the system initializer and 
put it in the program library under file name SYSINI. Then GETSI is put in the program 
library as a relocatable binary program. 

A subsequent system initialization run was made to check out GETSI; the listing shows 
it beginning to execute. 
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*P,F 

L,16 FAILED 01 

ACTION 

RP 

L,02 FAILED 02 

ACTION 

CU 

E * «* 



IN 

*K,I8 

IN 

LQ1 

IN 



I 



*N, SYSINI, , , B 
IN 

*K,I2 
IN 

*L,GETSI 
L08 
IN 



*Z 
J 

*p 

J 

*SI 

J 

SI IN 

SI 

*I,1 



Put System Initializer in Program Library 



Call in LIBEDT 



Input on lun 2 PTR - sys. ini. in rel. bin. form 
Absolutize on lun 8 (disk scratch) 



Absolutize in 96-word blocks for disk 
Printer failed 

Out of tape. Complete absolutizing 

Unpatched externals (unnecessary modules were taken out of sys. ini. ) - ignore 
Input now on 8 



File SYSINI, binary, placed in pgm. lib. 

Input now on lun 2 PTR (GETSI) 

Put GETSI in pgm. lib. in rel. bin. form 



Sign off LIBEDT 

CHECK IT OUT 

Turn off protect switch here! 
Call in GETSI 

GETSI gets SYSINI and types SI IN 
System initializer types SI 
Begin initialization! 



Q 

*v 

*Y, QQTEST, 2, QQQ8AB, 3, QQSPAC, 4 

*YM, LOADSD, 1, JOBENT, 2, JOBPRO, 3, JPLOAD, 4 

*YM, JPST, 5, JPCHGE, 6, JBKILL, 7, JPT13, 8 

*YM, RCOVER, 9, LIBEDT, 10, MODI, 11, MOD2, 12 

*YM, MOD3, 13, BRKPT, 14, RESTOR, 15, MOD4, 16 

*YM, DEBUG, 17, DSUTIL, 18, TYPEED, 19, DSTART, 20, RSTART, 21 

*YM, QQFMT1, 22, QQCOM, 23, QQANAB, 24, QQUTL1, 25 etc. 



c 
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(" ^ 14.4 TRANSFERRING RECORDS 

In this example, LIBEDT was used to transfer a card image from the card reader to 
paper tape. The *T image in the example was then attached to the end of a series of 
paper tape programs being loaded, to cause the loader to end loading. 



O 
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TRANSFER RECORDS FROM ONE LUN TO ANOTHER 

LIBEDT *T (*T option is used to transfer rel. bin. paper 

tapes which are SI input to high portion of disk 
so that disk input may be made to SI. ) 



*Z 

J 
*p 

J 

*LIBEDT 
LIB 

IN 



*T,12,A,11,A,1 

IN 



Transfer from LUN 12 (CR), ASCII mode, to LUN 11 (PTP), 
ASCII mode, one record (1 card) 
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14. 5 ABSOLUTIZING AND LINKING SUBPROGRAMS 



Next, LIBEDT was used to build a Utopia system. This involves loading, absolutizing, 
and linking a series of relocatable binary paper tapes. Only the routines applicable to 
the particular configuration were included. The new Utopia in core can then be used to 
punch out an absolute paper tape image of itself. 



O 
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BUILD UTOPIA SYSTEM USING LIBEDT 



*p 

J 

*LIBEDT 
LIB 

IN 



Call in LIBEDT 



*K,I2,P11 -*- 
IN 



*P «« 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

RP 

L,02 FAILED 

ACTION 

CU -« 



02 



02 



02 



02 



02 



02 



02 



02 



02 



02 



02 



02 



E * 



IN 



*Z 
J 



Assign input LUN 2 (PTR) output LUN 11 (FTP) 

Load and absolutize tapes 
UTOPIA 

UMAINF 

USILLY 

U1711 

UDISK 

CARDIN 

U1729 

U601MT 

UTODMP 

UDALP 

CKOUT 

UTLAST 

Wind up load and link 

Externals missing; ignore; punch tape 

Sign off LIBEDT 
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BUILD UTOPIA PRINT OUT 



UTOPIA 


2210 


UMAINF 


2392 


USILLY 


25A8 


U1711 


3258 


UDISK 


343E 


CARDIN 


3680 


U1729 


3707 


U601MT 


38A9 


UTODMP 


39 BE 


UDALP 


3AA2 


CKOUT 


444A 


UTLAST 


4F23 


E10 




CKD 




PCR 




DKM 




MAR 




VDM 




LPRINT 




RDM 





"\ 



> 



Routine names and addresses where loaded 



< 



> 



Missing Externals 

(These are for modules not included in this 
system) 



J 



Applicable Utopia routines for customer's configuration can be loaded and linked to- 
gether, then an absolutized tape can be punched. It can then be loaded by a cksum 
loader (which must be loaded by a bootstrap loader). 

Utopia modules could also be loaded and linked and put on program library in rel bin 
form (with Libedt *L). Then Utopia could be called from TTY with *UTOPIA. 
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APPENDIX A 



Ref. No. 

1 
2 
3 

4 
5 
6 
7 
8 
9 
10 



Reference Title 

Reference Manual 

Codes 

Assembler Reference Manual 

1700 Macro/ Assembler Reference Manual 

Utility Reference Manual* 

Operating System Reference Manual 

1700 4K Assembly System (ADB) 

Input/ Output Specifications Manual 

Systems Manual 

ADSD General Information Manual 



Publication No. 

60153100 
60163500 
60171600 
60176300 
60172300 
60174600 
60176500 
60165800 

60152900 
60187600 



*Utility Assembler requires 8K system. 
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1700 INSTRUCTION EXECUTION TIMES 



STORAGE REFERENCE 



o 





Instruction 


LDA 


Load A 


STA 


Store A 


LDQ 


Load Q 


STQ 


Store Q 


ADD 


Add A 


SUB 


Subtract 


ADQ 


AddQ 


AND 


AND with A 


EOR 


Exclusive OR with A 


RAO 


Replace Add One in Storage 


MUI 


Multiply Integer 


JMP 


Jump 


RTJ 


Return Jump 


DVI 


Divide Integer 


SPA 


Store A, Parity to A 



Execution Time 
(microseconds)* 



*Add 1. 1 microsecond if Storage Index Register is used. 
Add 1. 1 microsecond for each level of Indirect Addressing. 
Add 1.1 microsecond for two word instructions. 



2. 


2 


2. 


2 


2. 


2 


2. 


2 


2. 


2 


2. 


2 


2. 


2 


2. 


2 


2. 


2 


3. 


3 


7. 





1. 


1 


2. 


2 


9. 





2. 


2 



REGISTER REFERENCE 



SLS 

INP 

OUT 

ENA 

ENQ 

INA 

INQ 

ARS 

QRS 

ALS 

QLS 



Instruction 

Selective Stop 
Input to A 
Output from A 
Enter A 
Enter Q 
Increase A 
Increase Q 
A Right ShifP\ 
Q Right Shift Nv 
A Left Shift / 
Q Left Shift _/ 



Execution Time 
(microseconds) 



1.1 

1. 1 min. , 10 max. 

1. 1 min. , 10 max. 

1.1 

1.1 o 

1.1 

1.1 

1.1 + (shift count *. 1) 
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REGISTER REFERENCE (Cont) 



LRS 
LLS 

NOP 

EIN 

UN 

EXI 

SPB 

CPB 



Instruction 

Long Right Shift 
Long Left Shift 

No Operation 
Enable Interrupt 
Inhibit Interrupt 
Exit Interrupt State 
Set Program Protect 
Clear Program Protect 



Execution Time 
(microseconds) 



1.1 + (shift count *. 2) 

1.1 
1.1 
1.1 
2.2 
2.2 
2.2 
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INTERREGISTER 



o 



SET 

CLR 

TRA 

TRM 

TRQ 

TRB 

TCA 

TCM 

TCQ 

TCB 

AAM 

AAQ 

AAB 

EAM 

EAQ 

EAB 

LAM 

LAQ 

LAB 

CAM 

CAQ 

CAB 



Distraction 

Set to Ones 

Clear to Zero 

Transfer A 

Transfer M 

Transfer Q 

Transfer Q V M 

Transfer Complement A 

Transfer Complement M 

Transfer Complement Q 

Transfer Complement Q V M 

Transfer Arithmetic Sum A, M 

Transfer Arithmetic Sum A, Q 

Transfer Arithmetic Sum A, Q V M 

Transfer Exclusive or A, M 

Transfer Exclusive or A, Q 

Transfer Exclusive or A, Q V M 

Transfer Logical Product, A, M 

Transfer Logical Product A, Q 

Transfer Logical Product A, Q V M 

Transfer Complement Logical Product A, M 

Transfer Complement Logical Product A, Q 

Transfer Complement Logical Product 

A, Q VM 



Execution Time 
(microseconds) 



> LI 
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SKIPS 



SAZ 

SAN 

SAP 

SAM 

SQZ 

SQN 

SQP 

SQM 

SWS 

SWN 

sov 

SNO 
SPE 
SNP 
SPF 
SNF 



Instruction 

Skip if A = +0 

Skip if A ± +0 

Skip if A = + 

Skip if A = - 

Skip if Q = +0 

Skip if Q t +0 

Skip if Q = + 

Skip if Q = - 

Skip if Switch Set 

Skip if Switch Not Set 

Skip on Overflow 

Skip on No Overflow 

Skip on Storage Parity Error 

Skip on No Storage Parity Error 

Skip on Program Protect Fault 

Skip on No Program Protect Fault 



Execution Time 
(microseconds) 



\ 
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APPENDIX C 



UTILITY ASSEMBLER PSEUDO INSTRUCTIONS 



NAMn 



o 



ENDe 



ENTn ,n 2 ,... 



EXTn ,n 2 ,... 



EXT*n , n , . . . 

-L Li 



BSSn 1 (s 1 ),n 2 (s 2 ) .. 



BZSn^s^iySg) ,.. 
COMn^s^n^) ... 



DATn 1 (s l ),n 2 (s 2 ) ,... 



AIJO 6 , e , . . . 
1 & 



n <^2 



ALF n <C2n characters 



*> 



NUM c , c ,... 

J. Li 



First instruction in source program. The 
name, n, if given, identifies the program. A 
numeric location field for this instruction 
specifies the absolute starting location for the 
program; a symbolic location field is ignored. 

Last instruction in source program. The entry 
point, e, if given, is the start of the. program. 

Entry points, n^, that may be r e f e r r e d to by 
other programs. 

External locations, n^, of other programs that 
are referred to by this program. 

Similar to EXT except that references to the 
external names, nj, are made relative. 

Reserves a block of program storage locations. 
The names, m, identify segments of s^ words in 
length. 

Similar to BSS. hi addition, zero fills the block. 

Reserves a block of common storage locations. 
The names, m, identify segments of sj words in 
length. Data may not be pre stored in the com- 
mon block. 

Reserves ablock of data storage locations. The 
names, n^, identify segments of sj words in 
length. Data may be prestored in the data 
block. 

Defines address expressions to be stored as 
address constants. The addresses may be posi- 
tive or negative and absolute or relocatable. 
Parentheses indicate indirect addressing. 

Stores ASCII alphanumeric characters into con- 
secutive locations of program storage. 

Stores decimal or hexadecimal constants, cj, in 
consecutive locations in program storage. 



o 
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UTILITY ASSEMBLER PSEUDO INSTRUCTIONS (CONT) 

ORG e Assemble subsequent instructions beginning at 

the address expression, e, which may be pro- 
gram relocatable, data relocatable or absolute. 

ORG* e Resumes assembling instructions immediately 

after the location preceding the ORG instruction 
or the first ORG if more than one in a string. 

EQU n (e ),n (e ) , . .. Equates names, m, to address expression, ej. 

NLS Inhibits list output of assembly. 

LST Enables list output of assembly following is- 

suance of a NLS instruction. (Listing is auto- 
matic unless NLS is given. ) 

SPC v Spaces v lines on the typewriter. 
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APPENDIX D 
ASSEMBLY ERROR MESSAGES 

ERROR LISTING 

A list of errors occurring in passes 1 and 2 precedes the program listing on the standard 
comment I/O unit. If the L option is selected, errors in pass 3 precede the source line on 
the list output. A decimal error count is printed at the end of each subprogram. If L is not 
selected, error messages are output on the standard comment unit. 

Format for pass 1 and 2 error messages: 



Column 
1-3 
4 

5-6 
7-8 
Format for pass 3 error messages: 



Contents 

3 -digit line number 

space 

** 

2-character error code 



O 



Column 


Contents 


1-6 


****** 


7-8 


2-character error code 


9-18 


********** 



Following are the error message codes and their definitions. 



Message 
**DS 



**UD 

**so 



Meaning 
Doubly defined symbol. A name in 

1) location field of a machine instruction or an ALF, NUM, or ADC 
pseudo instruction 

or 

2) address field of an EQU, COM, DAT, EXT, BSS, or BZS pseudo 
instruction 

has been used again in one of the above fields. 

Undefined symbol in an address expression. 

Available storage for saving symbol names exceeded; no more names 
may be defined. Symbol table overflow. 
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Message 
**EX 



**LB 

**IX 
**op 

**OR 
**RG 



**RL 



**OV 

**SQ 
**MD 
**MC 
**PP 

**NN 

**MO 



Meaning 
Illegal expression. One of the following: 

1) No forward referencing of some symbolic operands 

2) No relocation of certain expression values 

3) A violation of relocation 

4) Possibly a comment is being interpreted as an address field in an 
instruction which has no address field 

Numeric or symbolic label contains illegal character. The label is 
ignored. 

Illegal index register; specified by symbol other than Q, I or B. 

1) Illegal symbol in operation code field, e. g. , LDI TAG 

2) Illegal operation code terminator 

3) Could also be caused by error in macro 

Numeric or symbolic operand in address expression contains illegal 
characters. 

Illegal register for interregister instructions, e.g., CLR I 

1) Symbol other than A, Q, or Mused in address field of interregister 
instruction, or the same symbol used more than once. 

2) Registers separated by other than a comma. 

1) Violation of relocation. 

2) Violation of a rule for instructions which require the expression 
value to 

a) be absolute 

b) have no forward referencing of symbolic operands. 

Numeric operand overflow-numeric value greater than allowed, e. g. , 
1 wd. rel. more than $7F. 

Sequence error 

Macro definition error 

Macro instruction error 

Error in previous pass of compilation 

No NAM statement. Blank name will be inserted by assembler. 

Overflow of the load-and-go area of mass storage. 
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LOADER ERROR MESSAGES 

\ ) All loading error messages appear on the standard print output device. 

E01 Irrecoverable input error; terminates loading. 

E03 Illegal or out-of-order input block; terminates load. Also, this diagnostic appears 

on the comment device when illegal input from that device is detected. The comment 
device is interrogated for a new statement. 

E04 Incorrect common block storage reservation. Occurs if the first NAM block to de- 

clare common storage does not declare the largest amount. The loader uses the 
previously declared length and continues. 

E05 Program too long or loader table overflow. Terminates loading. Occurs if program 

to be loaded exceeds available unprotected core. It may be possible to load the pro- 
gram by rearranging the order of loading to insure entry points are defined before 
they are referred to as external symbols. Loader produces a memory map and list 
of unpatched externals prior to terminating the load. 

E06 Attempt to load information in protected core; terminates loading. 

E07 Attempt to ORG into part of data storage beyond assigned block; terminates loading. 

E08 Duplicate entry point; loading continues. The succeeding program is loaded, over- 

laying the program with the duplicate entry point. 

E10 Unpatched external. External name is printed following diagnostic. The operator 

may choose to terminate the job or continue execution in spite of unpatched exter- 
nals (with *(CR)). A *E(CR) will cause the loader to search the directory of core 
resident entry points for the missing external. 

Ell Error in HEX block; loader skips remainder of block and resumes loading with the 

next block. Image of HEX block in error is printed following diagnostic. 

E12 Two programs reference same external name, one with absolute addressing, the 

other relative addressing. 

E13 Undefined or missing transfer address; occurs when loader does not encounter a 

name for the transfer address to begin execution, or the name encountered is not 
defined in loader's table as an entry point name. 
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JOB PROCESSOR ERROR MESSAGES 



PARITY, hhhh 



OV 



L,nn FAILED ee 



ALT, aa 
ACTION 

J01,hhhh 

J02,hhhh 

JO 3, statement 

J04, statement 

JO 5 

J06,hhhh 

J07,hhhh 
J08,hhhh 



Memory parity error at location hhhh-^g. Message appears on output 
comment device. 

Overflow of volatile storage. Message appears on output comment 
device. 

Informs operator of device failure. 

nn logical unit number 

ee code indicating cause of failure as follows: 

00 I/O hangup 

01 Internal or external reject 

02 Alarm 

03 Parity error 

04 Checksum error 

05 Internal reject 

06 External reject 

Informs operator an alternate device, aa, has been assigned. 

Requests operator action when a failed device has no alternate. The 
device is identified in the FAILED diagnostic. 

Program protect violation, hhhh is current contents of P register. 
Standard print output device. 

Illegal request or parameters at location hhhh^g. Standard print out- 
put device. 

Unintelligible control statement is output with the diagnostic. Standard 
output device. 

Illegal or unintelligible parameters in control statement. Standard 
print output device. 

Statement entered after manual interrupt illegal. Output comment 
device. 

A threadable request was made at level one when no protect processor 
stack space was available, or an unprotected threaded request was 
made at level one. Standard print output device. 

Unprotected program tried to access protected device from location 
hhhh. Standard print output device. 

Attempt to access read only unit for write, or write only unit for read, 
or an attempt to access an unprotected r eque s t on a protected unit. 
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APPENDIX E 
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AMERICAN STANDARD CODE FOR INFORMATION INTERCHANGE (ASCII) 


Bit Configuration 


Symbol 


Bit Configuration 


Symbol 


000 


0000 


NUL 


001 


1011 


ESC 


000 


0001 


SOH 


001 


1100 


FS 


000 


0010 


STX 


001 


1101 


GS 


000 


0011 


ETX 


001 


1110 


RS 


000 


0100 


EOT 


001 


1111 


US 


000 


0101 


ENQ 


010 


0000 


SP 


000 


0110 


ACK 


010 


0001 


I 


000 


0111 


BEL 


010 


0010 


tT 


000 


1000 


BS 


010 


0011 


# 


000 


1001 


HT 


010 


0100 


$ 


000 


1010 


LF 


010 


0101 


% 


000 


1011 


VT 


010 


0110 


& 


000 


1100 


FF 


010 


0111 


t 


000 


1101 


CR 


010 


1000 


( 


000 


1110 


SO 


010 


1001 


) 


000 


1111 


SI 


010 


1010 


* 


001 


0000 


DLE 


010 


1011 


+ 


001 


0001 


DC1 


010 


1100 


> 


001 


0010 


DC2 


010 


1101 


- 


001 


0011 


DC3 


010 


1110 


• 


001 


0100 


DC4 


010 


1111 


/ 


001 


0101 


NAK 


011 


0000 





001 


0110 


SYN 


011 


0001 


1 


001 


0111 


ETB 


011 


0010 


2 


001 


1000 


CAN 


011 


0011 


3 


001 


1001 


EM 


011 


0100 


4 


001 


1010 


SS 


011 


0101 


5 
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ASCII (Cont) 








Bit Configuration 


Symbol 


Bit Configuration 


Symbol 


Oil 0110 


6 


101 0010 


R 


Oil 0111 


7 


101 0011 


S 


Oil 1000 


8 


101 0100 


T 


Oil 1001 


9 


101 0101 


U 


Oil 1010 


: 


101 0110 


V 


Oil 1011 


> 


101 0111 


w 


Oil 1100 


< 


101 1000 


X 


Oil 1101 


= 


101 1001 


Y 


Oil 1110 


> 


101 1010 


z 


Oil 1111 


? 


101 1011 


[ 


100 0000 


\ 


101 1100 


] 


100 0001 


A 


101 1101 


100 0010 


B 


101 1110 


A 


100 0011 


C 


101 1111 


- 


100 0100 


D 


110 0000 


@ 


100 0101 


E 


110 0001 


a 


100 0110 


F 


110 0010 


b 


100 0111 


G 


110 0011 


c 


100 1000 


H 


110 0100 


d 


100 1001 


I 


110 0101 


e 


100 1010 


J 


110 0110 


f 


100 1011 


K 


110 0111 


g 


100 1100 


L 


110 1000 


h 


100 1101 


M 


110 1001 


i 


100 1110 


N 


110 1010 


3 


100 1111 


O 


110 1011 


k 


101 0000 


P 


110 1100 


1 


101 0001 


Q 


110 1101 


m 
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ASCII (Cont) 




Bit Configuration 


Symbol 


110 


1110 


n 


110 


1111 





111 


0000 


P 


111 


0001 


q 


111 


0010 


r 


111 


0011 


s 


111 


0100 


t 


111 


0101 


u 


111 


0110 


V 


111 


0111 


w 


111 


1000 


X 


111 


1001 


y 


111 


1010 


z 

f~ 


111 


1011 




111 


1100 




111 


1101 


] 


111 


1110 


1 


111 


mi 


DEI 
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APPENDIX F 

(" " 

^ ANSWERS TO EXERCISES ON CHAPTER II 

1. a. 0010 1101 1010 1110 is 2DAE^ 

16 

b. 1000 1111 1100 0111 is 8FC7,„ 

lb 

c. 1111 1111 1100 0000 is FFCO^ 

16 

2DAE 16 = 11694 1() 

8FC7, = -28728 

lb 10 

FFC0 16 = - 63 10 

2DAE + 8FC7 + FFCO = 

BD75_+ FFCO... = BD36_ 
16 16 16 

No overflow was generated. 

2. a. 4095 = 0FFF = 0000 1111 1111 1111 

O b - -17„ = FFEE„ =1111 1111 1110 1110 o 

v — <-" 10 lb <L 

c. 255., A = 00FF„„ = 0000 0000 1111 1111 
10 16 ^ 

3. By extending the sign. Consider the 8 bit positive number: 
00000111 - Decimal value 7 

t 

I Sign Bit. Extend the sign bit to the left 8 places - 0000 0000 0000 0111 2 - same value 
of 7 but the number now occupies a 16-bit field. 

The same applies for a negative number. FE-, gis -1 in an 8-bit field and FFFE-^g is also 
-1, but in a 16-bit field. 
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ANSWERS TO EXERCISES ON CHAPTER V - Shift and Skip Instructions 

1. a. Shifts QA left 16 bits. This effectively switches the data in A to Q and Q to A. 

b. Will JUMP to P + 4 if the overflow indicator is on, and clear the indicator. Will go 
to P + 1 if overflow indicator is not on. 

c. Shifts the data in Aright 18 bits. This will clear A if bit 15 was originally a or will 
set A to all l ! s if bit 15 was originally a 1. It also wastes time since the maximum 
necessary shift count to accomplish the same result is 15. 

d. Neither the A nor the Q register is specified so the instruction is essentially a time 
delay. It takes l.l + .lx8 = 1.9 microseconds to execute and does nothing to the A 
or Q registers. 

2. Q = 0000 
A = E3C4 
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ANSWERS TO EXERCISES ON CHAPTER V - Constant Mode of Addressing 

1. a. A =1059 Q=0000 

b. A = 0024 Q = 0000 

c. A = 4142 Q = 4040 
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ANSWERS TO EXERCISES ON CHAPTER V - Absolute Mode of Addressing 
1. 



LDA- 
ADD 

STA- 


$FF 

=N$10 

$FF 


also 




LDA- 

ADD 

STA- 


I 

=N$10 

I 



I can be used in place of $FF for storage reference class of instructions. One-word ab- 
solute mode is used since $FF is in the communications region. 

2. a. 4016 

b. 003F 

c. 4016 (However, this is two-word absolute indirect which requires two core cells 

and 1. 1 microseconds more time. Since the base address is in the commu- 
nications region, one-word absolute indirect should be used. ) 

3. a. This will decode as C000; A will be 0, yielding not one-word absolute but the first 

word of constant mode. The base address for one-word absolute must be 01 to FF. 

b. One-word absolute could have been used since the base address is F3. 

c. Nothing. This is a legitimate example of two-word absolute indirect. Bit 15 of the 
second word (P+l) will be set because of the parentheses and bits 14-0 of P+l will 
contain the address equivalent for TEST. 
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ANSWERS TO EXERCISES ON CHAPTER V - Relative Mode of Addressing 

1. a. Forward, 31 hex locations from P. 

b. Backward, 1000., „ or 4096 rt from P+l, or OFFF, „ or 4095, „ from P. 

lb 10 lb 10 

c. Backward, one location back from P. 

2. a. Two-word relative 

b. One-word absolute indirect 

c. Two-word absolute indirect 

d. One-word relative 

e. Constant. Two-word. 

f. Two-word relative indirect 

g. Constant. Two-word, 
h. One-word absolute 

3. The communications region is fixed and will never move with the program. If the pro- 
gram moved and not the communications region, the relative distance which had been 
established would be worthless. Fixed areas of core are addressed absolutely, and those 
that move with the program are addressed relatively. 
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ANSWERS TO EXERCISES ON CHAPTER V - Indexing 

1. a. B is used to indicate use of both Q and I index registers. Should be written 

LDA AB, B. 

b. Nothing, if A is defined as a legitimate symbol elsewhere in the program. 

c. No indexing with shift class instructions, only storage reference class. 

2. a. A = 0000 

b. A = 0023 

c. A = 0023 

3. It will loop forever since the reduced index register I value is never stored back. Need 
a STQ- I after the ADQ =N-1. 

Answer to indexing problem: 

a. $1234 

b. $02ED 

c. $2311 

d. $1111 
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ANSWERS TO EXERCISES ON CHAPTER VI - Utility Assembler 

1. a. Symbols for the EQU and BSS pseudo ops are defined by appearing in the address 
field. 

b. TAG is a doubly defined symbol. It cannot be an EXT. 

c. START should be an entry point. The program should look like: 



Location 


Opcode 


Address 
EXAMP 


Comments 




NAM 






ENT 


START 






EQU 


LED(720) 




TAG 


NUM 


-72, $FFFF,72 






BSS 


TAG11(25) 






EXT 


LAD 




START 


LDA+ 


TAG 






STA+ 


LAD 





END 



START 



2. The common area cannot be preset. 

3. Since the common area is fixed, all references to it can safely be made absolutely. This 
is necessary instead of a relative addressed mode for run anywhere programs. 

4. When the reference is made to LIST+3, the operand is unpredictable. The loader skips 
over the LIST area at load time. A BZS should have been used. It would be worthwhile 
at this point to refer to reference 5 or 6 for more information concerning the loader since 
this information is not covered in this manual. 
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ANSWERS TO EXERCISES ON CHAPTER VI - Macro Assembler 

1. a. FEE9 

002F 

b. 4142 

c. 0A00 

d. FFFE 

2. LDA =N$1000 
ADD =N$1000 

3. TAG ALF Z,ERROR6 Z 

TAG1 ALF Z, LOGICAL UNTO Z 

4. The symbol TE is declared local to the macro and cannot be called by the main program. 
Also, since the code is inserted in-line, the $7FF3 could be executed as an instruction. 
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ANSWERS TO EXERCISES ON CHAPTER VIII 



1. 



LOOP 



FIRST 



STA* 


FIRST 


ENA 


$20 


LDQ 


=N$A1 


OUT 


-1 


INQ 


-1 


INP 


-1 


SAN 


1 


JMP* 


*-2 


INP 


-1 


ALS 


8 


INP 


-1 


STA* 


(FIRST) 


RAO* 


FIRST 


JMP* 


LOOP 


ADC 






a. This program is run anywhere. 

b. Starting location for the checksum program is initially placed in the A register. 

c. Reader will run out of tape and stop on a lost data condition. 



O 



F-9 



APPENDIX G 



c 



c 



o 



APPENDIX G 
SOLUTIONS TO PROBLEMS IN CHAPTER V 

ADDRESSING PROBLEM 

a. 1234 

b. 02ED 

c. 2311 

d. 1111 

MOVE 

The MOVE routine moves 1001 numbers from $1000-$2000, inclusive, to $3000-$4000, in- 
clusive. 



$2000 



$1000 




SUM 



The SUM routine sums 1001^g numbers from $1000-$2000, inclusive. The answer is stored 
in $3000. 



$2000 



$1000 




o 
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CHNG 

The CHNG routine swaps two arrays, inverting them. The contents of locations $1000-$2000 
are swapped and inverted with the contents of locations $3000-$4000. 



$2000 



$1000 




$4000 



$3000 



The swap is completed when the last address in ADDR has been decremented past $3000. 

SUB 

The SUB program picks up the actual data from the calling program and stores them in its 
locations SUBAG1, SUBAG2, and SUBAG3. The E OR =N$8000 put an indirect bit on the 
contents of location SUB (which in the example was $502). This caused the LDA* (SUB) to get 
the actual data, 10, etc. After picking up all the data, the subroutine updated the return ad- 
dress to $505 and ANDed off the extra indirect bit, AND =N$7FFF, so the return would be 1 
to the proper place. 

The subroutine saved the regis ters when it was entered, and restored them when it exited, 
which most subroutines would do. 

SORT 

The SORT routine sorts 16 numbers, in ascending order, in core locations $500-$50F, in- 
clusive. The method used is to push the smallest number to the top, the next smallest number 
to the next-to-top, etc. 

CLRPB 

The CLRPB subroutine clears protect bits on the core area from$2000-$4000, inclusive. The 
parameters passed by the calling routine are the last word address of the buffer (LWA) and 
the first word address (FWA). The subroutine will work for any addresses passed to it. It 
uses the A register and overflow indicator for loop c ontr ol. When the last word address is 
subtracted from $7FFF in A, the number left will be such that when Q reaches the last word 
address +1 and the AAQ instruction is executed, overflow will occur, and the exit will be 
made from the loop. The SOV instruction before entering the loop turned off the overflow 
indicator in case it may have been on. The CLRPB subroutine must be a protected routine 
itself or the protect switch must be off. 
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CONVRT 

The CONVRT subroutine converts a hexadecimal number which it receives in A to the ASCII 
codes for the decimal number. It packs the codes in a buffer, BUF, and returns to the caller 
with the buffer address in A. 

The method used is to divide the number by 10, in hexadecimal arithmetic, and save the re- 
mainders. Each time a divide is done, the remainder in Q will be used to get the ASCII code 
for the number from a table, TAB. 

It would have been possible in this example to simply add $30 to each remainder for the con- 
version. However, the table-look-up method is used for illustration. Also note that the 
routine puts the characters in one buffer, BUF1, then packs them in BUF for the caller. 

The CONTST program checks out CONVRT by calling it to convert a number $37 CO, then 
writing the answer on the teletypewriter in ASCII. 



O 
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SOLUTIONS TO PROBLEMS IN CHAPTER VI 



VALUE 


PROBLEM 






NAM 


TEST 




COM 


DUMMY(10),X(10) 




DAT 


DUM(6), COUNT (1) 




EQU 


LPMASK($2) 




ENT 


START 




EXT* 


VALUE 


MASK 


BZS 


MASK(l) 


START 










CLR 


Q 




STQ 


COUNT 




LDA 


VALUE 




AND- 


LPMASK+6 




ALS 


8 




STA* 


Mask 




ENQ 


9 


SEARCH 


LDA+ 


X,Q 




AND 


=N$3F00 




EOR* 


MASK 




SAN 


2 




RAO 


COUNT 




SQZ 


EXIT-*-l 




INQ 


-1 




JMP* 


SEARCH 


EXIT 


JMP* 
END 


(START) 



NAM gives the program a name. ENT gives it an entry point. START is where execution 
begins, but it does not appear on the END card, implying that it is a subroutine. COM de- 
clares the X's in COMMON; COUNT declares the 7th word of the data block for the answer. 
DUMMY and DUM space over locations not used in this program. The EXT* declares VALUE 
external (it must be an entry point in the other program), and the * implies it is relative. 
The BZS initializes MASK to 0. The EQU declares that LPMASK is location $2. 



INI MACRO 

The two listings on the following pages show one way to write the INI macro. The first 
listing does not have the macro expanded, while the second does (M option). 

The test routine was run with the STOP switch set. When the computer stopped, the Q reg- 
ister was selected on the console for display. It contained a 6, to indicate that the macro 
worked. 

The INI is not exactly like an INA or INQ because of the size of operands allowed. Line 0008 
has an ADD =N ! N» instead of an INA T N T . 
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0001 








NAM 


INIMAC 


0002 
0003 






INI 


MAC 
LOC 


N 
SA 


0004 
0005 






•SA» 


JMP* 
NUM 


**2 



0006 
0007 








STA* 
LDA- 


•SA« 
I 


0008 
0009 








ADD 
STA- 


=N»N« 
I 


0010 
0011 








LDA* 
EMC 


tSA« 


0012 
0013 


P0000 


0000 


INIMAC 


ENT 



INIMAC 



0014 
0015 


P0001 
P0002 


0842 
40FF 




CLR 
STQ- 


Q 
I 


0016 
0016 


P0003 


1802 




INI 


6 


0016 
0016 


P0004 
P0005 


0000 
68FE 








0016 
0016 


P0006 
P0007 


COFF 
8000 








0016 


P0008 
P0009 


0006 
60FF 








0016 
0017 


POOOA 
POOOB 


C8F9 
EOFF 




LDQ- 


I 


0018 
0019 


POOOC 


0000 




SLS 

END 


INIMAC 





OOFF INIMAC OOOOP COO 0004P 
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0001 








NAM 


INIMAC 


0002 
0003 






INI 


MAC 
LOC 


N 
SA 


0004 
0005 






•SA» 


JMP* 
NUM 


*+2 




0006 
0007 








STA* 
LDA- 


•SA« 

I 


0008 
0009 








ADD 
STA- 


=N»N« 
I 


0010 
00U 








LDA* 
EMC 


•SA« 


0012 
0013 


POOOO 


0000 


INIMAC 


ENT 



INIMAC 



0014 
0015 


P0001 
P0002 


0842 
40FF 




CLR 
STQ- 


Q 
I 


0016 
0016 


P0003 


1802 




INI 
JMP* 


6 
**2 


0016 
0016 


P0004 
P0005 


0000 
68FE 


[00 


NUM 
STA* 



[00 


0016 
0016 


P0006 
P0007 


COFF 
8000 




LDA- 
ADD 


I 

=N6 


0016 


P0008 
P0009 


0006 
60FF 




STA- 


I 


0016 
0017 


POOOA 
POOOB 


C8F9 
EOFF 




LDA* 
LDQ- 


[00 
I 


0018 
0019 


POOOC 


0000 




SLS 

END 


INIMAC 







OOFF INIMAC OOOOP fOO QQQ4P 
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SOLUTION TO PROBLEMS IN CHAPTER VIII 

CKASSM PROBLEM (8. 4) 

The first INDIR request, line 13, is for the write request at line 34, out of the buffer MSG, 
line 25, on the teletypewriter. "NEXT MESSAGE SHOULD INDICATE VERIFICATION." 

The next, at line 15, is to s tar t the write request at line 32 to write a message from MSG1, 
line 26, on the disk. "MACRO ASSEMBLER ON 1700 NOW OK. " This message will be written 
on the disk concurrently with the first message which is going out on the TTY. 

At line 16, a status request is made to wait for the disk write to finish. Then, at line 19, the 
message on the disk is read back in, line 28, into a different buffer, BUF, which is a BZS at 
line 27. At line 20, status is taken from line 28 to wait for completion of the disk read. 
Finally, this message is transferred out of BUF to the teletypewriter at line 23, after which 
an exit is made at line 24. 

The program works out the assembler by the ass or tment of requests used to transfer the 
message around. Note that no completion routines are used; it will be obvious that if the two 
messages come out, it worked; and if they don't, it didn't. 

The errors which could be found are: 

1. SQN 1 at lines 17 and 21. This is the main error and the instruction effectively doesn't 
do anything. It was intended to loop on the indirect status request until the operation in 
progress bit (bit 15 of Q) became clear. To accomplish that, a SQP instruction should 
have been used. Since Q is word 8 of the disk physical device table, it will never be a 
whole word of zero (upon which the SQN could be used). Only bit 15 should be checked 
for zero. Therefore, as the program is set up, control falls right through to initiate the 
disk read at line 19, then the teletypewriter write at line 23. 

The program works because of the speed of the peripherals involved and the threading of 
requests onto the driver for each logical unit. The correct message is written, not 
garbage. 

What actually happens (if the SQN's are used instead of SQP's) is: 

a. The first TTY message is initiated. 

b. The disk write is initiated. 

c. The disk read is initiated; it is threaded onto the disk driver after the disk write, 
since both are at priority 0. Therefore, the read will not be done until the write is 
finished. 

d. The second TTY write is initiated and is threaded on behind the first write, again 
since the priority is the same (RP = 0). That is why the second line comes out after 
the first, as it should. 

e. The second line does not contain garbage because the TTY is slow compared with the 
disk; the disk buffer has been written and read back in before the TTY driver gets 
ready to write it out. Any change in hardware or priorities involved could cause a 
mess. 
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2. The next item to note is the binary write on the teletypewriter at line 23. Normally an 
ASCII write would be used. No damage is done because the words being written already 
contain ASCII characters which can be sent directly to the teletypewriter. 

3. Note the formatted write and read on the disk. This is not an error but implies that the 
disk sector driver is in the system, not the disk word driver. 

4. Note the disk sector address words which must be inserted after the macros at lines 30 
and 33. They indicate sector 1 in the scratch area. This is not an error. 

The version of the CKASSM routine which is used to check out the macro assembler contains 
SQN instructions at P0007 and P000D. This is probably to test the s tatus request itself and 
then also to check out the operation of MSOS. 
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SOLUTIONS TO PROBLEMS IN CHAPTER XI 



SOLUTION TO RUN ANYWHERE PROBLEM 

Program AVERAGE is written as a nondestructive run anywhere subroutine which may be 
called to compute an average. The buffer address in the calling routine is X, and the number 
of words is 10. Note that all of the addressing in the program is relative. 



O 



0001 






0002 






0003 






0004 


P0000 


0001 


0005 


P0001 


0000 


0006 


P0002 


0C09 


0007 


P0003 


0A00 


0008 


P0004 


68FB 


0009 


P0005 


01A0 


0010 


P0006 


8A00 X 




P0007 


7FFFX 


0011 


P0008 


01 B3 


0012 


P0009 


D8F6 


0013 


P000A A000 




P000B 


7FFF 


0014 


P000C 


0142 


0015 


P000D 


0DFE 


0016 


P000E 


18F7 


0017 


P000F 


E8F0 


0018 


P0010 


0FC1 


0019 


P0011 


0F61 


0020 


P0012 


3000 




P0013 


000A 


0021 


P0014 


1CEC 


0022 







AVG 



LOOP 



TEST 



AV 



NAM 


AVERAGE 


EXT* 


X 


ENT 


AVG 


BZS 


OVFL(l) 








ENQ 


9 


ENA 





STA* 


OVFL 


sov 





ADD 


X,Q 


SNO 


TEST-*-l 


RAO* 


OVFL 


AND 


=N$7FFF 


SQZ 


AV-*-l 


INQ 


-1 


JMP* 


LOOP 


LDQ* 


OVFL 


ALS 


1 


LRS 


1 


DVI 


=N10 


JMP* 


(AVG) 


END 





RELATIVE EXTERNAL X 



N WORDS 9 

CLEAR A AND OVFL 

RELATIVE TO OVFL 

2 WORD RELATIVE EXT 



RELATIVE TO OVFL 



RELATIVE TO LOOP 
RELATIVE TO OVFL 



RELATIVE TO AVG 



G-9 



PROB1 calls AVERAGE and punches out the answer, 4, and remainder, 5. The program is 
run anywhere, and note the relative addressing used in the punch request. ANS is before the 
request and COMPL is after the request. 



c 



0001 
0002 
0003 
0004 



0005 
0006 
0007 

0008 

0009 

0010 
0011 
0012 
0013 
0014 
0015 
0016 
0017 
0018 
0019 

0020 
0021 



P0000 
P0001 
P0002 
P0003 
P0004 
P0005 
P0006 
P0007 
P0008 
P0009 
P000A 

P000D 
P000E 
P000F 
P0010 

pooh 

P0012 
P0013 
P0014 
P0015 
P0016 
P0017 
P0018 
P0019 
P001A 
P001B 
P001C 
P001D 
P001E 



0001 

0002 

0003 

0004 

0005 

0006 

0007 

0008 

0009 

0000 

0003 

OOEA 

5800 X 

7FFF X 

6800 

FFF9 

4800 

FFF9 

54F4 

0501 

0007 

0000 

0003 

0003 

7FF5 

14EA 

0162 

5800 X 

7FFF X 

18FF 



X 



ANS 



START 



NAM PROB1 

EXT* AVG,IOERR 

ENT START, X 

NUM 1,2,3,4,5,6,7,8,9,0 



RELATIVE EXTERNAL AVG 



BZS 


ANS(3) 


EQU 


ADISP($EA) 


RTJ 


AVG 



COMPL 



STA 
STQ 

RTJ- 

NUM 

ADC* 

NUM 

NUM 

NUM 

ADC 

JMP- 

SQP 

RTJ 

NUM 
END 



ANS 

ANS+2 

($F4) 

$0501 

COMPL+1 



$0003 

3 

ANS-*+5 

(ADISP) 

2 

IOERR 

$18FF 
START 



TWO-WORD RELATIVE EXT 
RELATIVE TO ANS 



PUNCH OUT ANS AND REM 

SET X BIT 

RELATIVE TO COMPL (FWD) 



RELATIVE TO ANS 



HANG WHEN FINISHED 
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Here is an error example of incorrect relative addressing used in the punch request. Note at 
line 16 that the ADC* ANS+5 assembles as FFF5, because ANS comes before the ADC in the 
program. A positive increment is required, relative to the first word of the parameter 
string, so it should have been 7FF5. The ADC ANS-*+5 should have been used. 

Li debugging this program, the punch tape was studied. (Be sure to get it right side up. ) 
Note that the codes punched are: 

03 

FF 

F5 

14 

EA 

By studying the output, it was noticed that these are the codes for part of the program, in- 
dicating that the buffer ANS was not output, but program codes were. Hence the discovery of 
the FFF5 at P0019. 
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G-ll 



0001 
0? 
0003 
CO 04 



0005 
0006 
0007 

0008 

0009 

0010 

0011 

001? 

0013 

0014 

0015 

-00 16- 

0017 

0018 

0019 

0020 
0021 



POOOO 
P0001 
HO 00? 
POO 3 
P0004 
POO 05 
P0006 
POO 07 
P « 
P0009 
POOOA 

poo on 

POO OP 
POOOP" 
POO 10 
POOH 
P001? 
P0013 
POO 14 
POO 15 
POO 16 
POO 17 
P0018 
P0019 
P001 A 

POO IP 

P001C 
* v 10 
P001E 



0001 
000? 
3 
04 
0005 
06 
0007 
0008 
09 
0000 
0003 
OOEA 
5800 
7FFF 
6800 
FFF9 
4800 
FFF9 
54F4 
0501 
0007 
0000 
0003 



000 3 
FFF5 
14EA 



0162 

580 
7FFF 
18FF 



ANS 



START 



COM PL 



NAM PR0B1 

FXT* AVGflOERR 

ENT STARTS 

NUM I,2f3«4,5t6,7,8>9,0 



BZS ANS (3) 

EOU AOISP(SEA) 

PTJ AVG 

ST A A MS 

STQ ANS + 2 



RTJ- 

NUM 
ADC* 

NUM 

NUN 
NUM 



($F4) 

$0501 

COMPL+1 



$ 3 

3 



( AOC* ANS+5 "*) 



JMP- 

SQP 

RTJ 



(AOISP) 

2 

IOERR- 



NUM S18FF 
END START 
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In order to verify that the programs were indeed run anywhere and nondestructive and did link 
correctly, coding was inserted to move them (after they ran one time) to higher core and run 
again. Two identical answers would indicate that the programs did run correctly. 

The following example includes coding added which will move 100-^q words, beginning at 
START, to $4000, and then jump to $4000 to re execute. This continues repeatedly. Since 
the program lengths are 28-^g and lD^g* for a total of 45-tg, the 100 1o (64-jg) words moved is 
sufficient. 

Another method would be to use the contents of locations $F7 and $ED to find the core address 
and program length, and use them in the move. 

When checkout methods such as this are used, remember that if the breakpoint package is in 
core it is physically located immediately above the last subroutine. Therefore, it would be 
wise not to move the programs on top of the breakpoint package and wipe it out. 
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0001 






0002 






0003 






0004 




OOF A 


0005 


P 


5800 X 




POO 01 


7FFF X 


0006 


P0002 


6800 




P0 00 3 


0024 


0007 


P0 004 


4800 




POO 05 


024 


0008 


POO 06 


54F4 


00 09 


POO 07 


501 


0010 


P0 008 


0007 


.0011 


P0009 


0000 


0012 


POOOA 


0003 


0013 


POOOR 


0003 


0014 


POOOC 


0020 


0015 


POOOD 


14EA 


0016 


POOOE 


0162 


0017 


POO OF 


5800 X 




P0010 


7FFF X 


0018 


POOH 


OAOO 


0019 


POO 1^ 


60FF 


0020 


P0013 


C9EC 


0021 


POO 14 


6500 




POO 15 


4000 


0022 


P0016 


OOFF 


0023 


POO 17 


COFF 


0024 


P0018 


099C 


0025 


POO 19 


0101 


0026 


P001 A 


18F8 


0027 


P001B 


1400 




P001C 


4000 


C028 


poo in 


0001 




POO IF 


0002 




P001F 


0003 




P0020 


0004 




P0021 


0005 




P0022 


0006 




P0023 


0007 




P0024 


0008 




P0025 


0009 




POO 26 


0000 


0029 


P0027 


0003 


0030 







START 



COMPL 



LOOP 



OUT 



NAM 


PR0B1 


EXT* 


AVG,IOERR 


ENT 


START, X 


EQU 


ADISP(SEA) 


RTJ 


AVG 


STA 


ANS 


STQ 


ANS + 2 


RTJ- 


($F4) 


NUM 


$0501 


ADC* 


COMPL+1 


MUM 





NUM 


$0003 


NUM 


3 


ADC 


ANS— * + 5 


JMP- 


(ADISP) 


SQP 


2 


RTJ 


IOERR 


ENA 





STA- 


I 


LDA* 


START, I 


STA + 


$4000,1 


RAO- 


I 


LOA- 


I 


INA 


-99 


SAZ 


OUT 


JMP* 


LOOP 


JMP + 


$4000 



^v 



> 



MOVE 



J 



NUM 



1,2,3,4,5,6,7,8,9,0 



ANS 



87S 
END 



ANS(3) 
START 
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To illustrate the use of the conversion routine, the following program MAIN calls AVG to com- 
pute an average, then calls CONVRT to convert the answer (which was returned in A by AVG). 
CONVRT returns a 3-word buffer address of the ASCII characters (in A) which the main pro- 
gram then stores down in the write request. 

Note that this is an absolute buffer address. The completion address, COMPL, must also be 
absolute, yet it is in the run anywhere program MAIN. For that reason, the program must 
absolutize the completion address at each run and store it at C in the write request. 

After the answer is computed once, MAIN calls the MOVE subroutine to move everything 
except CONVRT up to higher core locations, immediately following the original programs. 
Absolute addressing is used in MAIN to CONVRT so that the original copy of CONVRT is used 
for conversion, since it is not a run anywhere program. 

This would simulate a mass memory module using a core resident subroutine which always 
remained in the same place. Even if CONVRT had been moved, the original copy would still 
have been the one called. 

Note also that the flag used to control the move is addressed absolutely. This is so the ori- 
ginal flag in core will be used: set by one routine and checked by another. This will simulate 
run anywhere routines communicating with each other through a core resident flag cell, hi 
the current example, the flag could have been addressed relatively. 
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0001 
0002 
0003 



44AM- 



MAIN 



FRAN GIACOBBE - PHILA 
CLASS PROBLEM NO . 1 P . 



0004 
000 5 



ENT MAIN»X»MVFLAG 
EXT» AVGOIOVE 



0006 
0007 



EXT 



CONVRT 



0008 
0009 



» MAIN MUST BE LOADED FIRST* CONVRT LAST* 
■* MAIN ENTRY POINT MUST BE FIRST LOCATION 



FOR CHECKOUT 
IN MAIN 



0010 
0011 



P0000 580 1 



MAIN 



RTJtt 



■"•* 1 



ABSOLUTIZE COMPL ADDR 



0012 
0013 



P0001 
P0002 





C8FE 




LDAtt 







0014 



P0003 
POO 04 



8000 
0012 



ADD 



=XCOMPL-T 



0015 
0016 



P00'05 
P0006 



6808 
5800 



STA» 
PTJ 



C 
-AAAG- 



GO GET AVERAGE 



0017 



P000 7 
P0008 



7FFF 
5 4 



RTJ + 



CONVRT 



GO CONVERT ANSWER 



001 8 



P0009 
P00 0A 



7FFF 
6807 



STA* 



WRITE+6 



BUFFER ADDRESS 



0019 
0020 



P000H 
P0 0C 



54F4 
0C01 



WRITE 



RTJ- 

NUM 



($F4) 
SOC01 



GO WRITE ANSWER 



0021 
0022 



P000D 
P000E 



0000 
0000 



ADC 
NUM 



0023 
002' t 



P000F 
P0010 



1004 
0003 



NUM 
NUM 



$1004 
-3 



0025 
0026 



P0011 
P0012 



0000 
14EA 



ADC 
JMP- 




(<EEA) 



0027 
0028 



P0013 
POO 14 



0161 
18FF 



COMPL 



SOP 
J4UM- 



CKMOVE 
S18FF 



HANG IF ERROR 



0029 



P0015 
PQ016 



C400 
0025 



CKMOVE 



LDA + 



MVFLAG 



FIRST OR SECOND RUN? 



0030 
0031 



P0017 
POP], 8 



0101 
JJkJLA. 



SAZ 
■IMP- 



GOMOVE-*-l 
-1SEJU 



0032 



POO 19 
P0Q1A 



180 
7FFF 



GOMOVE 



JMP 



MOVE 



0033 



P001B 
P001C 



15F9 
7FFF 



NUM 



$15F9»$7FFF*$65»2»0,$100D,8»$12»4,3 



POO ID 
P001E 



00b5 
00 02 



P001F 
P0020 




10QD 



P0021 
P0022 



0008 
0012 



P0023 
P0024 



0004 
1.1 fl 3 



0034 
0035 



P0025 0001 



MVFLAG 



BZS 

-E44Q- 



MVFLAG(l) 
M A IN 



oorr — main 



OOOOP X 

WRITE 000BP C 000DP COMPL 
CONVRT 0009X MOVE Q01AX AVG 



001DP MVFLAG 002 5 P T 



0001P 



0013P CKMOVE 
00 7X 



0015P GOMOVE 0019P 
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0001 
000? 
0003 



NAM 

EXT* 

EMT 



AVERAGE 
X 
-AAt€ 



BUFFER IN MAIN PGM 



0004 
0005 



P0000 
P0001 



0001 
0000 



OVFL 
AVG 



BZS 
-0 



OVFL(l) 
-0 



0006 
0007 



P0002 
P0003 



0C09 
UAOO 



ENQ 
-ENA- 



N WORDS 10 
CLE A R A AND OVFL 



0008 
0009 



P000<+ 
P0005 



68FB 
01A0 



STA* 
SQV 



OVFL 
-0 



TURN OFF OVERFLOW INDICATOI 



0010 P0006 8A00 X LOOP 
P0007 7FFF X 



ADD 



X»Q 



ADD UP DATA 



0011 
0012 



P0008 
P0009 



01B3 
D8F6 



SNO 
RAO* 



TEST-*-l 
-OW4= 



IF OVERFLOW 



0013 



P000A 
P000B 



A000 
7FFF 



AND 



=N$7FFF 



0014 
0015 



P000C 
P000D 



0142 
ODFE 



TEST 



SQZ 

-tm- 



AV-»-l 
-4 



0016 
0017 



P000E 
P000F 



18F7 
E8F0 



-AV- 



JMP* 
LDQ» 



LOOP 
OVFL 



COMPUTE AVER A GE 



c 



0018 
0019 



P0010 
P0011 



0FC1 
0F61 



ALS 

4rRS- 



0020 



P0012 
P0013 



3000 
000A 



DVI 



=N10 



0021 
0022 



P0014 1CEC 



-ft LE A VE 



JMP* (AVG) 

A NSWER IN A A ND REM A INDER IN Q AND RETURN TO C AL LER 



0023 



END 



o 



AV 



OOFF AAAG- 

OOOFP X 



0001P OVFL 
0007X 



QQOOP LOOP 



0006P TEST 



OOOCP 
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0001 



NA M 



MO VE 



000? 
0003 



ENT 
EXT 



MOVE 
MVFL Aft 



0004 0022 
05 POO CiOuO 



MOVE 



EQU 
_Q 



ZERO($22) 
_0 



0006 P0001 COLD 

0007 POOP? 9QP7 



LDA- 
SUB- 



$ED 
-SEX 



FIGURE OUT N WORDS 



008 POO 3 90 
P000<+ Q0*+4 



SUB 



=N$44 



SUBTRACT OFF SIZE OF CONVR' 



0009 

nmn priori oh?? 



SO IT WONT GET MOVED 



TRA 



0011 P0006 C6F7 
001? P0007 6hED 



MOVLP 



LDA- 
STA- 



($F7) fO 
(ftF D) iQ 



MOVE IT 



0013 P000B ODFE 
01. 4 POO 09 01*tl 



INO 
SQ7 



-1 

niiT-ft-l 



0015 P000A 18KB 

0016 POO OB 040 X 01 



JMP* 
RAO-*- 



MOVLP 
MVFI Aft 



qFT MO\/Fn Fl AG 



P000C 7FFF X 
017 PO OO n FO F D 



i n o- 



$fd 



FTGURE OUT JUMP ADDRESS 



0018 
019 



P000E 
POO O F 



0U01 
1 ^?'? 



INO 
JMP- 



(7FR0) *Q 



JUMP TO MATN 



0020 



END 



OOFF MOVE 



O00OP ZERO 



0022 MOVLP Q006P OUT 



000BP 



MVFLAG 000CX 
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o 



o 



0001 
0002 



P0 00 
P0001 



1 
01 



-NAM- 
3SS 



CONVRT 

SAVEQ(l) » SAVE I (1) »SAVEA(1) 



0003 



P0002 
P0003 



0001 
00 3 



-WJf- 



-J££S- 



RUF(3) 



0004 
0005 



P0006 
P000C 



0006 
2E3 



BUF1 
SIGN 



BSS 

■mm- 



BUF1 (6) 
$2B » $2D 



0006 



P000D 
P000E 



002D 
30 



-4-AB- 



-mm- 



$30»S31»$32»$33»'S34t$35f < K36t$37»$38» < fi39 



P000F 
P0010 



0031 
0032 



P0011 
P0012 



0033 
003fr 



P0013 
POO 14 



0035 
0036 



P0015 
P0016 



0037 
0038 



P0017 0039 



0007 



-iW- 



CONVRT 



0008 
0009 



P001B 
P0019 



0000 
< > 8E6 



CONVRT 




STQfr 




SAVEQ 



0010 
0011 



P001A 
P0Q1B 



EOFF 
' i8 E5 



LOQ- 
STQ* 



SAVEI 



0012 
0013 



P001C 
P001D 



0842 
' i OFF 



CLR 
STQ- 



0014 
0015 



P001E 
POOl f 



0122 
0U01 



SAP 

-tm- 



POS 

-1 — 



0016 
0017 



POO 20 
P0021 



0864 
EAEA 



-RGS- 



TCA 
LDQtt 



A 
SIGN » Q 



0018 
0019 



P0022 
PQ023 



48E8 
E8EA 



STQ* 
LDQfr 



BUF1+5 
TAB + 



0020 
0021 



P0024 
P0025 



48E1 
EOOO 



STQ* 
LDQ 



BUF1 
- N$20 



0022 



P0026 
PQ027 



0020 
fr SDF 



STQ* 



BUF1+1 



0023 
0024 



P0028 
P0029 



48DF 
48DF 



STQ* 
STQ» 



BUF1+2 
BUF1+3 



0025 
0026 



P002A 
P002B 



48DF 
0842 



LOOP 



STQ* 
CLR 



BUF1+4 
-Q 



0027 
0028 



P002C 
P002D 



0106 
3000 



SAZ 



OUT 
=N10 



0029 



P002E 
P002F 



000A 
EAOE 



4^0* 



TAB » fl 



0030 
0031 



P0030 
P0031 



4905 
DOFF 



STQ* 
RAO- 



BUF1»I 
-4 



0032 
0033 



P0032 
P0033 



18F8 
40FF 



-OUT- 



JMP* 
STQ- 



LOOP 
-4 



0034 
0035 



P0 034 
P0035 



0C05 
CAOO 



BACK 



ENQ 
LDA* 



5 
BUF1 » Q 



0036 
0037 



P0036 
P0037 



0FC8 
ODFE 



ALS 
-J-NO- 



8 
--4- 



0038 
0039 



P0038 
P0039 



8ACD 
69C9 



ADD* 
STA* 



BUF1,Q 
BUF » I 



0040 
0041 



P003A 
P0 3B 



DOFF 



RAO- 
INQ 



I 
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oo'tg poo3C 01 n 



-SGH- 



DONE 



0043 P003D 1HK7 
OOV i P003E E8C1 



DO N E 



JMP* 
LDQ* 



BACK 
SAVED 



0045 
0' i 6 



P003F 
PUO' i O 



C8C1 
bO f- F 



LDA* 
ST A » 



SAVEI 
4 



047 PC 041 CO 
POO ' ' 2 3 f 



LDA 



=XBUF 



004P 
OO' t Q 



P0043 1CD4 



JMP* 
END 



(CONVRT) 



-0W= SAVEQ 



0000P SAVE! 



0001P SAVEA 



0002P BUF 



0003P 



BUF1 
LOOP 



0006P 
002BP 



SIGN 
OUT 



000CP 
0033P 



TAB 
BACK 



OOOEP 
0035P 



CONVRT 
-©£N€ 



0018P 
003EP 



POS 



0021P 



ADDRESSES WHERE 
PROGRAMS LOADED 



MAIN 



236C 



AVERAG 
MOVE 



2392 
23 A 7 



CONVRT 23B7 



MAP 



1 ENTRY POINT TABLE- 



MAI.N 
MOVE 



236C 
23A7 



X 
-A-V-G- 



2387 
2393 



MVFLAG 2391 CONVRT 23CF 
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TTY PRINTOUT 



o 



o 



* 

MI 
*p 

J 

*K,I13,P6 

J 

*ASSEM 

OPTIONS LX 

J 
*p 

J 

*L,8 

J 

*X 

+ 4263 

+ 4263 "* 

J 



MI 
*p 

J 
*UTOPlA 



Answers 



E * 

CKDISK - ENTER CKD/ FOR HEADING 

ADH,15F9,7FFF/ 

95F8 

ADH,95F8,65/ 

965D 

ADH, 965D, 2/ 

965F 

ADH, 965F, 100D/ 

A66C 

ADH,A66C,8/ 

A674 

ADH,A674, 12/ 

A686 

ADH,4,A686/ 

A68A 

ADH,A68A, 3/ 

A68D 
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Utopia was used to sum the hex numbers, to check out the answer. The sum is A68D-^g = 
42637.. q. Divide by 10., for a decimal answer of 4263. The remainder 7 was not considered 
when the answer was printed. Note that the numbers used did generate overflow in the sum, 
thereby checking out the average routine. (The average routine would work only for positive 
numbers. ) 

In analyzing and planning the move portion, the following simple method could be used with 
imaginary core addresses: 



Address 


Core 




1014 
100B 






100A 
1001 






1000 

00F7 
OOED 


1000 
100A 





T3 
CD 

O 
CD 
-4-a 
O 
U 



> move 10 words 



100A 
-1000 



100A 

+A 

1014 



By drawing a simple picture to move only 10 words, beginning at 1001 and showing the con- 
tents of $ED and $F7 (which will be used for indirect addressing) it can be determined that the 
program should subtract the contents of $F7 from $ED and use that answer, $A, for the index 
in Q. The store through $ED would be analyzed the same way: ($ED) + $A = $1014. By 
looking at the picture, one can see that Q should go from $A to 1; hence, the skip out of the 
loop should be after the last move when Q equaled 1. 
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The actual addresses involved after loading were: 



23FB 
23 B7 
23AC 
2392 
236C 

00F7 
OOED 



MOVE 



AVERAG 

MAIN 



CONVRT 
MOVE 
AVERAG 
MAIN 



236B 
23FA 



> 



second run: 
CONVRT not moved 



< 



/> first run 



23 FA 




26 


-236B 




15 


8F 




10 


-44 


CONVRT 


4B 


4B 


moved 





o 



The total number of locations involved was 8Fi g. Less CONVRT, left 4B-, g to move. Q was 
indexed from 4B^ 6 (the last location in MOVE) through 1 (the first location in MAIN). 



o 
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Solution to the AVG Reentrant Problem (11.3.2) 



0001 






0002 






0003 




OOBB 
OOBA 
0022 
0002 


0004 


P0000 


0000 


0005 


P0001 


0500 


0006 


P0002 


54BB 


0007 


P0003 


0006 


0008 


P0004 


0400 


0009 


P0005 


C8FA 


0010 


P0006 


6103 


0011 


P0007 


0844 


0012 


P0008 


6104 


0013 


P0009 


F101 


0014 


P000A 4105 


0015 


P000B 


01A0 


0016 


P000C 


E4FF 


0017 


P000D 


8622 


0018 


PO00E 


01B2 


0019 


P000F 


D104 


0020 


P0010 


A011 


0021 


POOH 


0D01 


0022 


P0012 


4522 


0023 


P0013 


0852 


0024 


POOH 


F105 


0025 


P0015 


0141 


0026 


P0016 


18F5 


0027 


P0017 


E104 


0028 


P0018 


0FC1 


0029 


P0019 


0F61 


0030 


P001A 3101 


0031 


P001B 


6101 


0032 


P001C 


4500 




P001D 


0000 


0033 


P001E 


C103 


0034 


P001F 


0500 


0035 


P0020 


68DF 


0036 


P0021 


54BA 


0037 


P0022 


0400 


0038 


P0023 


1CDC 


0039 







NAM AVG 
ENT AVG 
EQU AVOLA($BB), AVOLR($BA), ZERO($22), LPMASK($2) 



AVG 



LOOP 



TEST 



DV 



DIV 



EXIT 











iin 






RTJ- 


(AVOLA) 




NUM 


6 




EIN 






LDA* 


AVG 


SAVE RETURN ADDRESS 


STA- 


3,1 




CLR 


A 




STA- 


4,1 


ZERO OVERFLOW CELL 


ADQ- 


1,1 


LWA+1 IN Q 


STQ- 


5,1 


SAVE IN VOLA+5 


SOV 





TURN OFF OVERFLOW 


LDQ- 


(I) 


FWA IN Q 


ADD- 


(ZERO),Q 


ADD DATA TO A 


SNO 


TEST-*-l 




RAO- 


4,1 


COUNT OVERFLOW 


AND- 


LPMASK+15 


AND OUT SIGN BIT 


INQ 


1 


UPDATE ADDRESS 


STQ- 


(ZERO), I 


SAVE NEXT ADDRESS 


TCQ 


Q 


COMPLEMENT NEXT ADDRESS 


ADQ- 


5,1 


ADD LWA+1 


SQZ 


DV-*-l 


FINISHED WHEN MATCH 


JMP* 


LOOP 




LDQ- 


4,1 


PICK UP OVERFLOW 


ALS 


1 


SQUEEZE OUT SIGN BIT 


LRS 


1 




DVI- 


1,1 


DIVIDE FOR AVERAGE 


STA- 


1,1 


RETURN ANSWER IN A 


STQ+ 


0,1 


RETURN REMAINDER IN Q 


LDA- 


3,1 


RESCUE RETURN ADDRESS 


IIN 






STA* 


AVG 




RTJ- 


(AVOLR) 




EIN 






JMP* 


(AVG) 




END 







5 


LWA+1 


4 


OVERFLOW 


3 


RETURN 


2 


I 


1 


A (N WORDS) 


(D+o 


Q (FWA) 
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o 



o 



The following routine, NAM AVGTST, was used to check out the subroutine to see if it re- 
turned the correct answer. It only checks the answer and does not check the reentrancy. It 
asked AVG for an average of 9 words of a 10-word buffer X, and then punched the average 4 
and remainder 0. 

The method used to run the routine in the background, since VOLA is a protected routine, was: 

1. Assemble and load AVGTST and AVG under MSOS. Do not execute yet. 

2. Turn off protect switch on console. 

3. Turn off disk (to protect the system). 

4. Set P on the console to the beginning address of AVGTST and RUN. 

This method could be used to check out any routine in the background which links to system 
routines in protected core. If the system in core gets clobbered, the image on the disk is 
intact. 
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0001 
0002 
0003 
0004 
0005 

0006 

0007 
0008 
0009 
0009 
0009 
0009 

0009 
0009 

0010 
0010 
0010 
0011 
0012 



0013 
0014 



P0000 
P0001 
P0002 
P0003 
P0004 
P0005 
P0006 

P0007 
P0008 
P0009 
POOOA 
POOOB 
POOOC 
POOOD 

POOOE 
POOOF 
P0010 
POOH 
P0012 
P0013 
P0014 
P0015 
P0016 
P0017 
P0018 
POO 19 
P001A 
P001B 



0A09 

EOOO 

0011 P 

5800 X 

7FFFX 

6816 

4816 

54F4 
0501 
0008 
0000 
0003 
0002 
0013 

54F4 

OAOO 

14EA 

0000 

0001 

0002 

0003 

0004 

0005 

0006 

0007 

0008 

0009 

0002 



BEGIN 



NAM 


AVGTST 


ENT 


X, BEGIN 


EXT* 


AVG 


ENA 


9 


LDQ 


=XX 



XA 



RTJ 

STA* 
STQ* 
WRITE 



XB 
X 



EXIT 



JMP- 

NUM 



NUMBER OF WORDS 
BUFFER ADDRESS 



AVG 



TEMP SAVE ANSWER 

TEMP+1 SAVE REMAINDER 

3, XB-XA-1, TEMP-XA-1, 2, B, 0, 1, A, X 



($EA) 
0,1,2,3,4,5,6,7,8,9 



TEMP 



BSS 
END 



TEMP (2) 
BEGIN 



ANSWER: 4 
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After tes ting out AVG to see if it gives an answer, it is then necessary to check out its re- 
entrancy. In the following computer run, two programs (PGMA and PGMB) were set up, 
( ) each to call AVG as a subroutine. Links and a flag were added to the routines for test pur- 
poses only. PGMA calls AVG and AVG begins its calculation. It then checks a flag and causes 
a pseudo interrupt of itself, and causes PGMB to begin its run. PGMB calls AVG, gets an 
answer, punches it, and returns control back to the location in AVG where the pseudo interrupt 
occurred. AVG completes its calculation for PGMA, returns to PGMA, and PGMA punches 
its answer and hangs. 

Again, the programs are loaded under MSOS. Then the protect switch and disk are turned off 
while they execute. 

This method could be used as a skeleton to check a routine's reentrancy. 

The coding for testing reentrancy is marked by brackets in the example. 



O 



o 
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0002 








0003 








0004 


P0000 


0000 




0005 


P0001 


OAOA 




0006 


P0002 


EOOO 






P0003 


OOOF P 




0007 


P0004 


5400 X 






P0005 


7FFFX 




0008 


P0006 


6813 




0009 


P0007 


54 F4 




0010 


P0008 


0401 




0011 


P0009 


0000 




0012 


POOOA 


0000 




0013 


POOOB 


0003 




0014 


POOOC 


oooi 


9 


0015 


POOOD 


00i9 P 


1 

to 


0016 


POOOE 


18FF 


00 


0017 


POOOF 


0000 






pooio 


oooi 






POOH 


0002 






P0012 


0003 






P0013 


0004 






POO 14 


0005 






P0015 


0006 






P0016 


0007 






P0017 


0008 






P0018 


0009 




0018 


P0019 


0001 




0019 







PGMA 



X 



NAM 


PGMA 


ENT 


PGMA 


EXT 


AVG 








ENA 


10 


LDQ 


=XX 



RTJ+ 



ANS 



BSS 
END 



AVG 



STA* 


ANS 


RTJ- 


($F4) 


NUM 


$0401 


ADC 





NUM 





NUM 


$0003 


NUM 


1 


ADG 


ANS 


NUM 


$18FF 


NUM 


0,1,2* 



10 NUMBERS 
BUFFER ADDRESS X 

COMPUTE AVERAGE 



PUNCH ANSWER 



HANG 



ANS(i) 
PGMA 



ANSWER: 4 



0001 
0002 
0003 
0004 



O 



0005 




OOBB 
OOBA 
0022 
0002 




0006 


P0000 


0000 


AVG 


0007 


P0001 


0500 




0008 


P0002 


54BB 




0009 


P0003 


0007 




0010 


P0004 


0400 




0011 


P0005 


C8FA 




0012 


P0006 


6103 




0013 


P0007 


0844 




0014 


P0008 


6014 




0015 


P0009 


F101 




0016 


POOOA 


4105 




0017 


POOOB 


01A0 




0018 


POOOC 


E4FF 


LOOP 


0019 






* 


0020 






* 


0021 


POOOD 


6106 




0022 


POOOE 


C820 




0023 


POOOF 


0115 




0024 


P0010 


0A01 




0025 


POOH 


681D 




0026 


POO 12 


C106 




0027 


P0013 


1400 x 






P0014 


7FFF|X 




0028 






* 


0029 


P0015 


C106 


C 


0030 


P0016 


0000 


FINI 


0031 






* 


0032 






* 


0033 


P0017 


8622 




0034 


P0018 


01B2 




0035 


POO 19 


D104 




0036 


P001A 


A011 




0037 


P001B 


0D01 


TEST 


0038 


P001C 


4522 




0039 


P001D 


0852 




0040 


POO IE 


F105 




0041 


P001F 


0141 




0042 


P0020 


18EB 




0043 


P0021 


E104 


DV 


0044 


P0022 


0FC1 




0045 


P0023 


0F61 




0046 


P0024 


3101 


DIV 


0047 


P0025 


6101 




0048 


P0026 


4500 






P0027 


0000 




0049 


P0028 


C103 


EXIT 


0050 


P0029 


0500 




0051 


P002A 


68D5 




0052 


P002B 


54BA 




0053 


P002C 


0400 




0054 


P002D 


1CD2 




0055 


P002E 


0001 




0056 









NAM 
ENT 
ENT 
EXT 
EQU 





IIN 

RTJ- 

NUM 

EIN 

LDA* 

STA- 

CLR 

STA- 

ADQ- 

STQ- 

SOV 

LDQ- 



STA- 

LDA* 

SAN 

ENA 

STA* 

LDA- 

JMP+ 



LDA- 




ADD- 

SNO 

RAO- 

AND- 

INQ 

STQ- 

TCQ 

ADQ- 

SQZ 

JMP* 

LDQ- 

ALS 

LRS 

DVI- 

STA- 

STQ+ 

LDA- 

IIN 

STA* 

RTJ- 

EIN 

JMP* 

BZS 

END 



AVG 

AVG 

FINI 

PGMB 

AVOLA($BB), AVOLR($BA), ZERO($22),LPMASK($2) 



(AVOLA) 
7 

AVG 

3,1 

A 

4,1 

1,1 

5,1 



(I) 



6,1 

FLAG 

C 

1 

FLAG 

6,1 

PGMB 



ONE MORE WORD VOLATILE 
NEEDED 



FIRST OR SECOND CALL? 



6,1 




> 



RETURN AFTER INTERRUPT 



(ZERO),Q 

TEST-*-l 

4,1 

LPMASK+15 

1 

(ZERO), I 

Q 

5,1 

DV-*-l 

LOOP 

4,1 

1 

1 

1,1 

1,1 

0,1 

3,1 

AVG 
(AVOLR) 

(AVG) 
FLAG(l) 



ANSWERS: 

3 

4 
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0001 






0002 






0003 






0004 


P0000 


0000 


0005 


P0001 


6817 


0006 


P0002 


4814 


0007 


P0003 


COFF 


0008 


P0004 


680F 


0009 


P0005 


0A08 


0010 


P0006 


EOOO 




P0007 


001B P 


0011 


P0008 


5400 X 




P0009 


7FFFX 


0012 


POOOA 


6819 


0013 


POOOB 


54F4 


0014 


POOOC 


0401 


0015 


POOOD 


0000 


0016 


POOOE 


0000 


0017 


POOOF 


0003 


0018 


P0010 


0001 


0019 


POOH 


0023 P 


0020 


P0012 


COOO 




P0013 


0000 


0021 


P0014 


60FF 


0022 


P0015 


EOOO 




P0016 


0000 


0023 


P0017 


COOOO 




P0018 


0000 


0024 


P0019 


1400 X 




P001A 


7FFFX 


0025 


P001B 


0000 




P001C 


0001 




P001D 


0002 




P001E 


0003 




P001F 


0004 




P0020 


0005 




P0021 


0006 




P0022 


0007 


0026 


P0023 


0001 


0027 







PGMB 



SI 



SQ 



SA 



X 



NAM 


PGMB 




ENT 


PGMB 




EXT 


AVG, FINI 












STA* 


SA+1 ^| 




STQ* 
LDA- 


SQ+1 1 


SAVE REGISTERS 


STA* 


SI+1 J 




ENA 


8 


8 NUMBERS 


LDQ 


=XX 


BUFFER ADDRESS X 



L 



RTJ+ 



AVG 



STA* 


ANS 






RTJ- 


($F4) 




NUM 


$0401 




ADC 







NUM 







NUM 


$0003 




NUM 


1 




ADC 


ANS 




LDA 


=N0 


-N 




STA- 


I 






LDQ 


=N0 




> 


LDA 


=N0 


> 




JMP+ 


FINI 


} 


NUM 


0,1,2 


, ^ 


5,4,5,6,7 



COMPUTE AVERAGE 



PUNCH ANSWER 



RESTORE REGISTERS 



V,. 



RETURN TO AVG 



ANS 



BSS 
END 



ANS(l) 



ANSWER: 3 
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Another possible solution would be: 



AVG 



C 



LOOP 



TEST 



DV 



DIV 



EXIT 



NAM 


AVG 


ENT 


AVG 


EQU 


AVOLA($BB 


EQU 


LPMASK($2) 








iin 




RTJ- 


(AVOLA) 


NUM 


5 


EIN 




LDA* 


AVG 


STA- 


3,1 


LDA- 


I 


EOR- 


ONEBIT+15 


STA- 


I 


CLR 


A 


STA- 


4,1 


LDQ- 


1,1 


INQ 


-1 


ADD- 


(i),Q 


SNO 


TEST-*-l 


RAO- 


4,1 


AND- 


LPMASK+15 


SQZ 


DV-*-l 


INQ 


-1 


JMP* 


LOOP 


LDQ- 


4,1 


ALS 


1 


LRS 


1 


DVI- 


1,1 


STA- 


1,1 


STQ+ 


0,1 


LDA- 


3,1 


IIN 




STA* 


AVG 


LDA- 


I 


AND- 


LPMASK+15 


STA- 


I 


RTJ- 


(AVOLR) 


EIN 




JMP* 


(AVG) 


END 





o 



The indirect bit on the contents of I causes proper addressing to be used to add up the buffer. 
Only 15 bits of the address are used for the direct addressing used to access the other volatile 
locations. 
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SOLUTION TO THREAD PROBLEM. (11. 4. 3. 3) 

Solution: Never. ( 

The problem here is that the programmer thinks the request priority of 14 will override the 
running priority of 12, but this is not so. It is the driver's priority which must be considered, 
and the slow-equipment drivers usually run at 10. So, since the request is threaded as 
highest priority (14) on the queue for the logical unit (TTY, 4) and will be processed when the 
driver gets to run at its priority (10), the write will never be done. This is because the 
running program is hung in a loop at priority 12, waiting for an event which cannot occur (the 
thread word becoming zero) because the loop at 12 is locking out the driver. 

Process programs usually run at 4, 5, and 6 (below the drivers); this would eliminate the 
problem in the example program. However, any looping like this at any priority is going to 
slow down a system by locking out lower priorities. For example, if many process programs 
were coded this way, they could almost completely lock out job processing (which runs at 
and 1). It would be much better to code the write as follows, if it must run at 12: 



FWRITE,RP=14, CP^=13 





EQU 


ADISP($ 




RTJ- 


($F4) 




NUM 


$OCED 




ADC 


COMPL 




NUM 







NUM 


$18FC 




NUM 


35 




ADC 


BUF 




SQP 


OK-*-l 




JMP 


REJ 


OK 


JMP- 


(ADISP) 


COMPL 
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o 



o 



SOLUTION TO MMPGM PROBLEM. (11. 5. 7) 

Note that after the FWRITE is initiated (at P0017), the program return jumps to CORSUB and 
then schedules SYSPGM. CORSUB will run at the calling program's priority (4). Then, since 
SYSPGM is scheduled to run at 4 also, it will rot begin until MMPGM is finished. (This is 
perfectly legal, as long as SYSPGM does not need any of the data in MMPGM and does not 
store anything in MMPGM.) At P001C a jump is then made to the dispatcher to await com- 
pletion of the I/O. This all looks very good. 

However, the I/O has been going on concurrently and the driver runs at a very high priority 
(usually 10). If by any chance it finishes the write and transfers control to the completion 
routine WROTE (at P001D) at priority 6 before the RT J+ CORSUB and the schedule for SYSPGM 
are finished, the space MMPGM is in will be released. Surprise ! 

This is quite possible because other system programs at intermediate priorities (i. e. , 7 and 
9) could be locking out the MMPGM at 4, yet the driver at 10 would be plodding away at its 
write. Naturally the completion at 6 will be done (after the 7 and 8 are finished) before the 
priority drops back down to 4 to try to do the return jump to CORSUB and the schedule re- 
quest, which, of course, aren't there any more. 

The word on mass memory coding is: Be careful, and think! 
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A possible correction for the program would be: 





NAM 


MMPGM 




ENT 


MMPGM 




EXT* 


REQRE J, IOERR 




EXT 


CORSUB 




EXT 


SYSPGM 


ADISP 


EQU 


ADISP($EA) 


MMPGM 


NUM 


$C8FE 




STA* 


REL+2 




JMP* 


WRITE 


MSGBUF 


ALF 


*, MASS MEMORY EXAMPLE* 


WRITE 


FWRITE 


$FC, WROTE- *+l, MSGBUF-*+5, 10, A, 5, 6, 1, X 




SQP 


REQOK-*-l 




RTJ 


REQREJ 


REQOK 


RTJ+ 


CORSUB 




JMP- 


(ADISP) 


WROTE 


SQP 


2 




RTJ 


IOERR 




SCHDLE 


REL,4,X 




SQP 


2 




RTJ 


REQREJ 




SCHDLE 


(SYSPGM), 4,0 




SQP 


2 




RTJ 


REQREJ 




JMP- 


(ADISP) 


REL 


RELEAS 


0,T,0 




END 


MMPGM 



Iq this solution, if the completion routine is entered before the RTJ+ to CORSUB is finished, 
REL and SYSPGM will be put on the scheduler stack to be executed after the completion exit 
to the dispatcher allows MMPGM to be picked up from the interrupt stack. 

Another possible correction to the program, perhaps better, would be simply to change the 
completion priority in the FWRITE request from 6 to 3. That would insure that any priority 4 
work would be finished before the release is executed. However, this would cause the space 
MMPGM is in to be tied up until SYSPGM is finished, which was not the intent. 
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APPENDIX H 



o 



c 



o 



o 





********pp******** 










0001 






*p 








0002 






*ASSEM 








********A~\p******** 










********UD* ******* 










0003 


P0000 


0000 




NAM 


L 




?)c s|c sf: a(: :(<: * »fc H« (~) p =+= H< * * * * * * 










******* *UD******** 










0004 


P0001 


0000 




NAM 


DAN 




0005 




0000 




ORG 







0006 


0000 


OBOO 




NOP 






0007 


0001 


7FFF X 


LOWCOR 





DPNDNT 




0008 




OOFE 




ORG 


$FE 




0009 


OOFE OOBD P 


TEMPI 





ANYWHR 




0010 


OOFF 0000 


INDEX2 










0011 


0100 


0000 


ABSRNG 










0012 




0002 P 




ORG* 






0013 


P0002 


0000 


RE LOW 










0014 






* 






a 


0015 






* 






i 


0016 






* 








0017 






* 


EVALUATION OF ADD 




0018 






* 


*ABSOLUTE* 




0019 






*LABEL* 


*OPN* 


*ADDRESS* 




0020 


P0003 


COFE 




LDA- 


TEMPI 




0021 


P0004 


C2FE 




LDA- 


TEMPI, Q 




0022 


P0005 


C1FE 




LDA- 


TEMPI, I 




0023 


P0006 


C3FE 




LDA- 


TEMPI, B 




0024 


P0007 


C020 




LDA- 


$20 




0025 


P0008 


0014 




LDA- 


20 




********FX* : 


******* 










0026 


P0009 


cooo 




LDA- 


ABSRNG 




******** pL ******** 










0027 


POOOA 


C002 




LDA- 


RELOW 




?fC3fC?|(>{C2fO](2]C)|C LJ 1 _>(C>fC5fC5fs>fC>]C5f;>(C 










0028 


POOOB 


C010 




LDA- 


BLOCK6 



1700 

ADDRESSING EXAMPLES 
ASSEMBLED UNDER MSOS 2. 
OCT. 1968 



SET ABSOLUTE ADDRESS 

EXTERNAL SYMBOL 

RE-SET ABSOLUTE ADDRESS 



0029 P000C COOO 

********Uj) ******** 

0030 P000D COOO 



LDA- 



LDA- 



BLOCK3 



1700 ASSEMBLY EXAMPLES 
********STORAGE REFERENCE******** 

**GROUP 1** 
tESS FIELD RESULTS IN DESIRED OPERA 

*DESCRIPTION* 
NO INDEXING 
Q INDEXING 
I INDEXING 
DOUBLE INDEXING 
NUMERIC HEX EXAMPLE 
NUMERIC DEC EXAMPLE 

-DELTA OUT OF RANGE 

PROGRAM RELOCATABLE ADDRESS 

DATA RELOCATABLE ADDRESS 

COMMON RELOCATABLE 



*BA* 


*EFA* 


TEMPI 


TEMPI 


TEMPI 


TEMP1+(Q) 


TEMPI 


TEMP1+(00FF) 


TEMPI 


TEMPH{Q)K00Fl 


20 HEX 


20 HEX 


20 HEX 


20 DEC 



UNDEFINED UNDEFINED SYMBOL 



0032 
0033 
0034 
0035 
0036 
0037 
0038 
0039 



i 

CO 



P000E C822 
P000F CA21 
P0010 CB20 
POOH C8FC 
P0012 C8FD 
P0013 181D 

0040 P0014 C017 

0041 P0015 C010 

0042 P0016 COOOO 

0043 P0017 C0A6 



0045 
0046 
0047 
0048 
0049 



0050 

0051 

0052 

0053 

0054 

0055 
0056 



P0018 
P0019 
P001A 
P001B 
P001C 
P001D 
P001E 
P001F 
P0020 
P0021 
P0022 
P0023 
P0024 
P0025 



C800 

0017 

C800 

00A2 

CAOO 

OOAO 

5800 

009E 

C400 

OOFE 

C400 

0500 

C800 

0000 



* 


*RELATIVE* 




*LABEL* 


*OPN* 


* ADDRESS* 


BAKREL 


LDA* 


RELADR 




LDA* 


RELADR,Q 




LDA* 


RELADR, B 




LDA* 


BAKREL 




LDA* 


*-2 




JMP* 


RELADR 




LDA* 


TAGLRM- BAKREL 




LDA* 


$10 




LDA* 


ABSRNG 




LDA* 


ANYWHR 



*DESCRIPTION* *BA* 

DELTA=RELADR+(-*) RELADR 

DELTA=RELADR+(-*) RELADR 

DELTA=RELADR+(-*) RELADR 

DELTA=BAKREL+(-*) BAKREL 

DELTA+*-2+(-*) *-2 

JUMP ADDRESS=EFA RELADR 

FORM RELATIVE ADDRESS 

ABSOLUTE ADDRESS 

ABSOLUTE ADDRESS 

DELTA OUT OF RANGE 



****CONTINUATION OF STORAGE REFERENCE**** 
****GROUP l**** 



*EFA* 
RELADR 
RELADR+(Q) 
RELADR+(Q)+(00FF) 
BAKREL 
*-2 

RELADR 



* *LONG RELATIVE* 

*LABEL* *OPN *ADDRESS* 



LDA 

LDA 

LDA 

RTJ 

LDA 

LDA 

LDA* 
TAGLRM 



RELADR 

ANYWHR 

ANYWHR, Q 

ANYWHR 

TEMPI 

$500 

* 




*DESCRIPTION* 
M=RELADR+(-*.+l) 



*BA* *EFA* 

RELADR RELADR 



M=16 BIT REL ADDRESS ANYWHR ANYWHR 

Q INDEXING ANYWHR ANYWHR+(Q) 

JUMP ADDRESS=EFA ANYWHR ANYWHR 

ABSOLUTE ADDRESS, ASSEMBLED AS STORAGE 

ASSEMBLED AS STORAGE MODE 

WORD ONE OF LONG RELATIVE 
WORD TWO OF LONG RELATIVE 



o 



o 



0058 
0059 
0060 



0061 

0062 

0063 
0064 
0065 



P0026 C400 
P0027 00BD P 
P0028 C600 
P0029 OOBD P 
P002A C700 
P002B 0500 
P002C C400 
P002D 0000 
P002E 5400 
P002F OOBDP 



*LABEL* 
BACIND 



♦STORAGE* 
*OPN* 
LDA+ 



LDA+ 



MEMADR LDA+ 



TAGSM 



LDA- 



RTJ+ 



o 



*ADDRESS* 
ANYWHR 

ANYWHR, Q 

$500, B 

(0) 



ANYWHR 



♦DESCRIPTION* 
2ND WORD=ANYWHR 

Q INDEXING 

NUMERIC EXAMPLE 



WORD ONE Ot STORAGE MODE 
WORD TWO OF STORAGE MODE 
JUMP ADDRESS=EFA ANYWHR 



*BA* 


*EFA* 


ANYWHR 


ANYWHR 


ANYWHR 


ANYWHR+(Q) 


$500 


$500+(Q)+(00FF) 



ANYWHR 



i 

CO 



0067 
0068 
0069 
0070 
0071 
0072 
0073 
0074 
0075 
0076 
0077 



P0030 C4FE 



P0031 C4FF 
P0032 C420 
P0033 14FE 



* EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED ADDRESS OF OPERAND ADDRESS 

* INDIRECT* 

*LABEL* *OPN* *ADDRESS* *DESCRIPTION* *BA* 

RELADR LDA- (TEMPI) DELTA=TEMP1 (TEMPI) 

* LDA- (TEMPI), Q DELTA=TEMP1 (TEMPI) 

* LDA- (TEMPI), B DELTA=TEMP1 (TEMPI) 
LDA- (TEMP1+1) DELTA=TEMP1+1 (TEMP1+1) 
LDA- ($20) DELTA=$20 ($20) 
JMP- (TEMPI) JUMP ADDRESSEE FA (TEMPI) 



*EFA* 
(TEMPI) 
(TEMP1)+(Q) 
(TEMP1)+(Q)+(00FF) 
(TEMP1+1) 
($20) 

ANYWHR 



0079 
0080 
0081 



0082 



0083 



0084 



*STORAGE INDIRECT* 



P0034 C600 
P0035 8027 P 
P0036 C700 
P0037 802B P 
P0038 C400 
P0039 8700 
P003A 5400 
P003B 8027 P 



*LABEL* 
RELIND 



*OPN* 
LDA+ 

LDA+ 

LDA+ 

RTJ+ 



*ADDRESS* *DESCRIPTION* 

(BACIND+1) , Q 2ND WORD=BACIND+l 

(MEMADR+1), B 2ND WORD=MEMADR+l 

($700) NUMERIC EXAMPLE 

(BACIND+1) JUMP ADDRESS=EFA 



*BA* *EFA* 

(BACIND+1) ANYWHR+(Q) 

(MEMADR+1) $500+(Q)+(00FF) 

($700) ($700) 

(BACIND+1) ANYWHR 



0086 
0087 

0088 P003C CCEA 

0089 P003D CDED 

0090 P003F CFF6 



* *RELATIVE INDIRECT* 

*LABEL* *OPN *ADDRESS* 

LDA* (BACIND+1) 

LDA* (MEMADR+1) , I 

LDA* (RELIND+1),B 



♦DESCRIPTION* 
DELTA=BACIND+l+(-*) 
DELTA=MEMADR+l+(-*) 
DELTA=RELIND+l+(-*) 



*BA* *EFA* 

(BACIND+1) ANYWHR 
(MEMADR+1) $500+(00FF) 
(RELIND+1) ANYWHR+(Q)+(00FF) 



i 



0092 






* *LONG RELATIVE 


INDIRECT* 


0093 






*LABEL* 


*OPN* 


*AD DRESS* 


0094 


P003F 
P0040 


CCOO 
FFE6 




LDA 


(BACIND+1) 


0095 


P0041 
P0042 


CEOO 
007B 




LDA 


(ANYWHR),Q 


0096 


P0043 
P0044 


C400 
8700 




LDA 


($700) 


0098 






* 




****CONTI 


0099 






* 






0100 






* 


EVALUATION OF 1 


0101 






* 




N = NUMERIC 


0103 






* 


* CONSTANT* 




0104 






*LABEL* 


*OPN* 


* ADDRESS* 


0105 


P0045 
P0046 


COOO 
03E8 




LDA 


=N1000 


0106 


P0047 
P0048 


COOO 
1000 




LDA 


=N$1000 


0107 


P0049 
P004A 


COOO 

EFFF 




LDA 


=N-$1000 


0108 


P004B 
P004C 


COOO 
0026 P 




LDA 


=XBACIND 


0109 


P004D 
P004E 


COOO 
7FD9-P 




LDA 


=X-BACIND 


0110 


P004F 
P0050 


COOO 
4243 




LDA 


=ABC 


0111 


P0051 
POO 52 


C200 
1000 




LDA 


=N$1000, Q 


0112 


P0053 


COOO 




LDA- 





0113 


POO 54 


0000 


TAGCM 








********J£^£*: 


******* 








0114 


P0055 
P0056 


6400 
0000 




STA 


=N$0 


0115 


POO 57 
P0058 


COOO 
7FFB 




LDA 


=X-4 


0116 


POO 59 
P005A 


COOO 
8026 P 




LDA 


=X(BACIND) 



*DESCRIPTION* 
M=BACKIND+(-*)+l 



*BA* *EFA* 

(BACIND+1) ANYWHR 



16 BIT REL ADDRESS (ANYWHR) (ANYWHR)+(Q) 

ASSEMBLED AS STORAGE INDIRECT 



****CONTINUATION OF STORAGE REFERENCE**** 
****GROUP 3**** 
)RESS FIELD RESULTS IN DESIRED OPERA] 
X = ADDRESS A = ALPHANUMERIC 



*DESCRIPTION* *BA* 

NUMERIC EXAMPLE DEC P+l 

NUMERIC EXAMPLE HEX P+l 

NUMERIC EXAMPLE NEG P+l 

ADDRESS EXAMPLE P+l 

ADDRESS EXAMPLE NEG P+l 

ALPHA EXAMPLE P+l 

RA=(P+1) INDEXING* $1000 

WORD ONE OF CONSTANT MODE 
WORD TWO OF CONSTANT 

ASSEMBLER WILL NOT ALLOW 

NUMERIC WITH ADDRESS INDICATOR 

SET INDIRECT BIT ON ADDRESS VALUE 



*EFA* 
P+l 

P+l 

P+l 

P+l 

P+l 

P+l 

OPERAND 



/ A 



o 



i 



0118 






* 




0119 






* 


EVAL 


0120 






*LABEL* 


+OPN* 


0121 


P005B 


0847 




CLR 


0122 


P005C 


080C 




TRM 


0123 


P005D 


0811 




TRQ 


0124 


P005E 


0823 




TRA 


0125 


P005F 


081C 




TRB 


0126 


P0060 


0801 




SET 


0127 


POO 61 


0854 




TCQ 


0128 


POO 62 


0834 




AAQ 


0129 


P0063 


086A 




EAM 


0130 


P0064 


08B2 




LAQ 


0131 


POO 6 5 


08F4 




CAQ 


*****;t 4 +{.''X* ******* 






0132 


P0066 


0820 




TRA 


0134 






* 




0135 






* 


EVAL 


0136 






*LABEL* 


*OPN* 


0137 


POO 67 


0105 




SAZ 


0138 


P0068 


0156 




SQN 


0139 


P0069 


0115 




SAN 


4-*******T7< V ******** 






0140 


P006A 


0120 




SAP 


:+; ^c sjc ^ ^z sfc ifc^c T? "V" ^c 5|c >|< % % =jc % ^ 






0141 


P006B 


013A 




SAM 


0143 






* 




0144 






* 


EVAL 


0145 






*LABEL* 


*OPN* 


0146 


P006C 


OFAC 




QLS 


0147 


P006D 


0FD2 




ALS 


0148 


P006E 


0F7F 




LRS 


0149 


P006F 


OBOA 


SKI PAD 


NOP 


0150 


P0070 


0F53 




ARS 


0151 


P0071 


0F5F 




ARS 


0152 


P0072 


OFDA 




ALS 



****** **REGISTER TRANSFER******** 
EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED DESTINATION REGISTER 
♦ADDRESS* *DESCRIPTION* 

A,Q,M CLEAR A Q AND M REGISTERS 

A TRANSFER M TO A 

M TRANSFER Q TO M 

Q,M TRANSFER A TO Q AND M 

A TRANSFER INCLUSIVE OR OF M Q TO A 

M SET M TO ALL ONES 

A TRANSFER THE COMPLEMENT OF Q TO A 

A TRANSFER SUM OF A Q TO A 

Q TRANSFER EXCLUSIVE OR OF A M TO Q 

Q TRANSFER LOGICAL AND OF A Q TO Q 

A TRANSFER COMPLEMENT OF LOGICAL AND OF A Q TO A 

X ILLEGAL DESTINATION REGISTER 

********gj^jpg** ****** 

EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED SKIP COUNT 
♦ADDRESS* *DESCRIPTION* 

5 IF(A) IS SKIP FORWARD 6 PLACES ++1+SKIPCOUNT 

SKIPAD-*-l IF(Q) NEG SKIP TO SKIPAD (NON ABSOLUTE METHOD) 

SKI PAD SKIP COUNT OUT OF RANGE 



$10 
-5 



SKIP COUNT OUT OF RANGE 



NEG SKIP COUNT 



******** g JJ J jp rp g * * * * * * * * 

EVALUATION OF ADDRESS FIELD RESULTS IN DESIRED SHIFT COUNT 
♦ADDRESS* *DESCRIPTION* 

12 LEFT SHIFT Q 12 DECIMAL POSITIONS 

$12 LEFT SHIFT A 12 HEX POSITIONS 

31 RIGHT SHIFT Q/A 31 DECIMAL POSITIONS (31 = MAX) 

10 WAIT XX MICROSECONDS 

$33 SHIFT COUNT GREATER THAN $31 

DELTA SYMBOLIC SHIFT COUNT 

-5 NEG SHIFT COUNT 



i 

05 



0154 
0155 
0156 

0157 P0073 0A75 

0158 P0074 OCEA 

0159 P0075 0A7F 

;£ ^< =j< % ^c jfc % ;f: Tf V^; s)c>f; >)c sf: s)e ^« ^c 

0160 P0076 0A80 

4cs|<3t:5(<5|c3f:^;^'p , 'V'^c5(c^:4;>t:5|<5|cs)c 

0161 P0077 0A01 

0162 P0078 0A1F 

0163 P0079 OAEO 

>(; >(; sf: ^e ^t s|c 5|c =Jt 'C' V^of: * * * H« * * 

0164 P007A OAFF 

j(e ^c # s)< * * + * XT V" * * * *>l< * * ^ 

0165 P007B 0A02 

********gX* ******* 

0166 P007C 0A10 

0167 P007D OAOO 

0168 P007E 09FE 

0169 P007F 0D25 

0170 P0080 0206 

3)< 5(C !+: 5JC 3|< 3fC >)< # 17" V^ >fc >fc =fc + >K H' * 

0171 P0081 0287 

0172 P0082 0400 

0173 P0083 0500 

0174 P0084 0E04 

0175 P0085 0600 

0176 P0086 0700 

0177 P0087 0000 

0178 001F 



EVALUATION OF ADDRESS FIELD RESULTS IN VARIOUS PORTIONS OF ASSEMBLED INSTS 



*LABEL* 



*OPN* 

ENA 
ENQ 

ENA 

ENA 



* ADDRESS* 
$75 
-$15 
127 

128 



ENA 


257 


ENA 


DELTA 


ENA 


-DELTA 


ENA 


INDEX2 


ENA 


RE LOW 


ENA 


BLOCK6 


ENA 


BLOCK3 


INA 


-1 


INQ 


$25 


INP 


REJCTA- *-l 


INP 


REJCTA 


EIN 





UN 





EXI 


4 


SPB 





CPB 





REJCTA SLS 





EQU 


DELTA($1F) 



*DESCRIPTION* 
ENTER A WITH VALUE SPECIFIED IN ADDRESS FIELD 
NEG EXAMPLE 
DEC EXAMPLE (MAX VALUE) 

NEG. NUMERIC VALUE 

OUT OF RANGE NUMERIC VALUE 
POS. SYMBOLIC VALUE 
NEG. SYMBOLIC VALUE 

NEG. SYMBOLIC VALUE 

PROGRAM RELOCATABLE VALUE 

DATA RELOCATABLE VALUE 

COMMON RELOCATABLE VALUE 

INCREASE A BY THE VALUE SPECIFIED IN ADDRESS FD 

INCREASE Q 

INPUT TO A REJECT ADDRESS- P+1+DELTA 

DELT OUT OF RANGE 

ENABLE INTERRUPT SYSTEM 

INHIBIT INTERRUPT SYSTEM 

EXIT INTERRUPT ADDRESS FIELD = INTERRUPT 

SET PROTECT BIT (Q) = ADDRESS 

CLEAR PROTECT BIT (Q) = ADDRESS 

STOP IF STOP KEY SET 

EQUATE SYMBOLIC VALUE FOR ABOVE USE 



o 



i 



0180 
0181 
0182 
0183 
0184 
0185 
0186 



0187 

0189 
0190 
0191 
0192 
0193 



P0088 0030 P 
P0089 0026 P 
P008A 802A P 
P008B 7FCF-P 
P008C 7FF0 



P008D 1000 
P008E 03E8 
P008F EFFF 
P0090 FF9B 



********QL.Agg 2 PSEUDOS******** 
*ADC* ADDRESS CONSTANT PSEUDO 

THE ADDRESS EXPRESSIONS IN SUBFIELD ARE ASSEMBLED INTO CONSECUTIVE CELL 
LOCATIONS. IF ADDRESS EXPRESSION IS ENCLOSED IN PARENTHESIS THE ADDRESS 
BECOMES INDIRECT. 



*LABEL* 
ADLIST 



*OPN* 
ADC 



♦ADDRESS* 
RELADR, BACIND, (MEMADR), -RELADR 



-$F 



TREATED AS ONE WORD ADC 



* *NUM* NUMERIC CONSTANT PSEUDO 

* THE NUMERIC EXPRESSIONS IN SUBFIELD ARE ASSEMBLED INTO CONSECUTIVE CELL 

* LOCATIONS. THE CONSTANTS CAN BE EITHER DECIMAL OR HEX VALUES. 
*LABEL* *OPN* *ADDRESS* 

CONLST NUM $1000, 1000, -$1000, -100 



0195 
0196 
0197 
0198 



* *ALF* ALPHANUMERIC MESSAGE PSEUDO 

* THE ADDRESS FIELD CONTAINS THE NUMBER OF CELLS TO BE RESERVED FOR THE 

* REMAINING CHARACTERS IN FIELD. 
*LABEL* *OPN* *ADDRESS* 



I 

00 



0200 








-* 


0201 








* 


0202 








* 


0203 








* 


0204 








* 


0205 










0207 








* 


0208 








* 


0209 








* 


0210 








* 


0211 










0212 








* 


0213 


P0091 


5400 


X 






P0092 


0001 


X 




0214 


P0093 


0B00 






0215 


P0094 


5400 


X 






P0095 


0092 


X 




0216 


P0096 


OBOO 






0217 


P0097 


5401 






0218 


P0098 


OBOO 






********]£X* : 


******* 




0219 


P0099 


5400 


X 




0220 


P009A 


OBOO 






****** **]£2£* : 


******* 




0221 


P009B 


5000 


X 





*****CONTINUATION OF CLASS 2 PSEUDOS***** 
*ENT* ENTRY PSEUDO 

THIS PSEUDO WILL CAUSE A BINARY OUTPUT WHICH WILL ALLOW EXTERNAL 
SYMBOLS OF OTHER PROGRAMS TO BE DEFINED AT *LOAD TIME* 
*OPN* *ADDRESS* 

ENT START, BACIND 

*EXT* EXTERNAL PSEUDO 

THIS PSEUDO WILL ALLOW SYMBOLIC VALUES UNDEFINED IN THE INDEPENDENT 
PROGRAM TO BE MATCHED WITH ENTRY VALUES AND DEFINED AT LOAD TIME. 
*OPN* *ADDRESS* *DESCRIPTION* 

EXT DPNDNT DPNDNT WILL BE MATCHED WITH ENTRY POINT 

AT LOAD TIME. 
RTJ DPNDNT DPNDNT IS UNDEFINED IN CURRENT ROUTINE 



ASSEMBLED AS STORAGE 



NOP 




RTJ 


DPNDNT 


NOP 




RTJ- 
NOP 


(LOWCOR) 


RTJ* 
NOP 


DPNDNT 


RTJ- 


DPNDNT 



INDIRECT LINKING 



f A 



( 



0223 
0224 
0225 
0226 
0227 
0228 



0100 
009C P 



****CLASS 3 PSEUDOS**** 
<EQU* EQUATE PSEUDO 

TfflS PSEUDO WILL CAUSE A SYMBOLIC VALUE TO BE EQUATED TO ANOTHER 
SYMBOLIC VALUE OR TO A NUMERIC VALUE AND PLACED IN SYMBOL TABLE. 
*OPN* *ADDRESS* 

EQU START($100),HERE(*) 



0230 
0231 
0232 
0233 
0234 
0235 
0236 
0237 



P009C 0B00 
P009D 0010 
P00AD 0B00 



* *BSS* BLOCK STORE PSEUDO 

* TfflS PSEUDO WILL CAUSE A RESERVATION OF THE NUMBER OF CELLS SPECIFIED 
BY THE VALUE IN THE ADDRESS FIELD. THE CONTENTS OF THESE CELLS WILL BE 
UNCHANGED AT LOAD TIME. 

*LABEL* *OPN* *ADDRESS* *DESCRIPTION* 

INDICATOR TO SHOW CURRENT ADDRESS 



*OPN* *ADDRESS* 

NOP 

BSS BLOCK8($10) 

NOP 



INDICATOR TO SHOW CURRENT ADDRESS 



i 

CO 



0239 
0240 
0241 

0242 P00AE 0B00 

0243 P00AF 0005 

0244 P00B4 0B00 



* *BZS* BLOCK ZERO STORE PSEUDO 

* SAME AS BSS EXCEPT CELLS WILL BE SET TO ZERO AT LOAD TIME. 
*LABEL* *OPN* *ADDRESS* *DESCRIPTION* 

NOP INDICATOR TO SHOW CURRENT ADDRESS 

BLOCK2 BZS BLOCK9($5) 

NOP INDICATOR TO SHOW CURRENT ADDRESS 



0246 
0247 
0248 
0249 
0250 
0251 



0000 C 
0030 C 



* *COM* COMMON STORAGE PSEUDO 

* THE NAME OF THE BLOCKS AND THE SIZE ARE DEFINED IN THE ADDRESS FIELD 

* OF PSEUDO. THE STORAGE AREA WILL BE ASSIGNED TO THE AREA OF THE 

* LOADER AT LOAD TIME. 

* *OPN* *ADDRESS* *DESCRIPTION* 

COM BLOCK3($30),BLOCK4($100) BLOCK4=BLOCK3+$30 



0253 
0254 
0255 
0256 
0257 

0258 



0000 D 
0010 D 
P00B5 0B00 



*DAT* DATA STORAGE PSEUDO 

THE METHOD OF RESERVATION IS THE SAME AS COM EXCEPT THE AREA CAN 
BE PRESET. 
*OPN* *ADDRESS* *DESCRIPTIQN* 

DAT BLOCK5($10),BLOCK6($20*$20) 



NOP 







INDICATOR TO SHOW CURRENT ADDRESS 



0260 




* 


0261 




* 


0263 


0000 D 




0264 


DOOOO 0088 P 
DOOOl 002A P 
D0002 008D P 
D0003 009C P 




****** **"QD* ******* 






D0004 8000 




0265 


D0005 0001 
D0006 0002 
D0007 0003 
D0008 0004 
D0009 0005 




0266 


00B6 P 




a 0267 

i ***** 


P00B6 OBOO 




***RLi******** 




° 0268 


0000 




0269 


P00B7 0001 
P00B8 0002 
P00B9 0003 
POOBA 0004 
POOBB 0005 




0271 




* 


0272 




* 


0273 




* 


0274 




* 


0275 




* 


0276 




* 


0278 




* 


0279 




* 



ORG 
ADC 



METHODS OF PRESETTING DATA IN DATA AREA 
ALSO SHOWN IS ILLEGAL USE OF COMM AREA 

BLOCK5 PRESET TO DATA AREA 

ADLIST, MEMADR, CONLST, HERE, (WORD2A) 



NUM 



1,2,3,4,5 



ORG* 





NOP 





ORG 


BLOCK3 


NUM 


1,2,3,4,5 



RESET TO NORMAL COUNTER 
INDICATOR TO SHOW CURRENT ADDRESS 

SET COUNTER TO COMMON AREA 
ILLEGAL TO SET DATA IN COMMON 



********CLA.gg 1 psEUDOS******** 
NAM NAME PSEUDO 

THE NUMERIC VALUE IN LABEL FIELD WILL SET PROGRAM COUNTER TO AN 
ABSOLUTE VALUE. THE ADDRESS FIELD CONTAINS THE PROGRAM NAME. 
ONLY ONE NAM ALLOWED PER PROGRAM. NAM IS USED TO IDENTIFY INDE- 
PENDENT PROGRAMS. 

ORG PROGRAM COUNTER CONTROL PSEUDO 

COUNTER. IF NUMERIC IS USED PROGRAM WILL BE ASSEMBLED ABSOLUTE. 



o 



"A 





0281 




* 




0282 




* 




0283 




* 




0284 








0285 


P00BC OBOO 






0287 


OOBD P 






0289 


■ 


* 




0290 




* 




0291 




* 




0292 




* 




0293 




* 




0294 




* 




0295 






i 









ORG* RETURN PROGRAM COUNTER PSEUDO 

USED TO RETURN COUNTER TO NORMAL VALUE 
*OPN* *ADDRESS* *DESCRIPTION* 

ORG* 
NOP INDICATOR TO SHOW CURRENT ADDRESS 



EQU 



ANYWHR(*) 



*END* END PSEUDO 
MUST BE LAST CARD OF EACH PROGRAM, SYMBOL IN ADDRESS FIELD IS THE 
ADDRESS CONTROL WILL BE TRANSFERRED TO AT LOAD TIME. 

*OPN* *ADDRESS* 



END 



START 



I 


00FF 


LOWCOR 


0001 


TEMPI 


00FE 


INDEX2 


00FF 


ABSRNG 


0100 


RE LOW 


0002P 


BAKREL 


000EP 


TAGLRM 


0025P 


BACIND 


0026P 


MEMADR 


002AP 


TAGSM 


0002DP 


RELADR 


0030P 


RELIND 


0034P 


TAGCM 


0054P 


SKIPAD 


006FP 


REJCTA 


0087P 


DELTA 


001F 


ADLIST 


0088P 


CONLST 


008DP 


START 


0100 


HERE 


009CP 


BLOCK8 


009DP 


BLOCK9 


00AFP 


BLOCK3 


ooooc 


BLOCK4 


0030C 


BLOCK5 


0000D 


BLOCK6 


0010D 


ANYWHR 


00BDP 


DPNDNT 


0095X 






030 ERRORS 





















APPENDIX I 



r 



APPENDIX I 



COMMUNICATION REGION 



The communication region is the area of core below FF-i g. It can be addressed directly by a 
one-word instruction. Contents are defined by the following table. All locations are pro- 
tected except as noted. EQU names are noted also. 



Location 



Contents 



HEX Equivalent 





&1 


Reserved for the system 




LPMASK 


fc o 


0000000000000000 
0000000000000001 




1 




^ 




4 


0000000000000011 


3 




5 


0000000000000111 


7 




__£—...__ 


0000000000001111.- 


F 




7 


ooooooooooomli 


IF 




8 


ooooooooooiiliii 


3F 




9 


0000000001111111 


7F 




A" 


0000000011111111 


FF 




B 


0000000111111111 


IFF 




C 


0000001111111111 


3FF 




D 


0000011111111111 


7FF 




E 


0000111111111111 


FFF 




E 


0001111111111111 


1FFF 




1CL 


0011111111111111 


3FFF 




11 


0111111111111111 . 


7FFF 


NZERO 


* 12 


liiiiiHinimi 


FFFF 




13 


liimiiiiiiiiip 


FFFE 




14 


1111111111111100 


FFFC 




15 


1111111111111000 


FFF8 




16 


1111111111110000 


FFF0 




17 


1111111111100000 


FFE0 




18 


1111111111000000 


FFC0 




19 


1111111110000000 


FF80 




1A 


1111111100000000 


FF00 




IB 


1111111000000000 


FE00 




1C 


1111110000000000 


FC00 




ID 


1111100000000000 


F800 




IE 


1111000000000000 


F000 




IF 


1110000000000000 


E000 




20 


1100000000000000 


cooo 




21 


1000000000000000 


8000 


ZERO 


*22 


0000000000000000 


0000 



1-1 



Location 



Contents 



HEX Equivalent 



ONE BIT 


— ► 23 


0000000000000001 


0001 




24 


0000000000000010 


0002 




25 


00Q0000000000100 


0004 




26 


0000000000001000 


0008 




27 


0000000000010000 


0010 




28 


0000000000100000 


0020 




29 


0000000001000000 


0040 




2A 


0000000010000000 


0080 




2B 


0000000100000000 


0100 




2C 


0000001000000000 


0200 




2D 


0000010000000000 


0400 




2E 


0000100000000000 


0800 




2F 


0001000000000000 


1000 




30 


0010000000000000 


2000 




31 


0100000000000000 


4000 




32 


1000000000000000 


8000 


ZROBIT — 


► 33 


1111111111111110 


FFFE 




34 


1111111111111101 


FFFD 




35 


1111111111111011 


FFFB 




36 


1111111111110111 


FFF7 




37 


1111111111101111 


FFEF 




38 


1111111111011111 


FFDF 




39 


1111111110111111 


FFBF 




3A 


1111111101111111 


FF7F 




3B 


1111111011111111 


FEFF 




3C 


1111110111111111 


FDFF 




3D 


1111101111111111 


FBFF 




3E 


1111011111111111 


F7FF 




3F 


1110111111111111 


EFFF 




40 


1101111111111111 


DFFF 




41 


1011111111111111 


BFFF 




42 


0111111111111111 


7FFF 




43 


5 






44 


6 






45 


9 






46 
47 through B2 
B3 
B4 
B5 


A 16 
Reserved for process 

Logical unit number of s 

Top of thread of entries 

Address of FNR 


i cratch unit 

in schedule stack 




B6 
B7 


Address of COMPRQ 
Address of mask table 






B8 
B9 


Address of top of interrupt stack 
Address of request exit 



r 



1-2 



Location Contents HEX Equivalent 

-^v BA Address of volatile storage release routine - VOLR 

^-^ BB Address of volatile storage assignment routine - VOLA 

BC Address of absolutizing routine for logical unit number 

BD Address of S absolutizing routine 

BE Address of C absolutizing routine 

BF Address of N absolutizing routine 

CO Most significant bits of first scratch area sector number 

CI Least significant bits of first scratch area sector number 

C2 Logical unit number of the library unit 

C3 Most significant bits of sector number of first program library di- 
rectory block 

C4 Least significant bits of sector number of first program library 
directory block 

C5 through E3 Reserved for FORTRAN (unprotected) 

E4 Used for load and go (unprotected) 

E5 Address of timer handler 

E6 Length of system library directory 

E7 Index to first mass storage entry in the system library directory 

E8 Countdown register 

E9 Real time clock 

EA Address. of dispatcher 

EB Address of system library directory 

("' ,, EC Temporary highest unprotected location + 1 

^— -.s^ ED Temporary lowest unprotected location - 1 

EE Used by job processor for returns from loader, etc. 

EF Current priority level \- PRLVL 

FO Address of first available volatile storage 

Fl Length of table of presets 

F2 Address of table of presets 

F3 Address of breakpoint program when in core (unprotected) 

F4 Address of entry for system requests (unprotected) 

F5 Highest core location - MAXCOR 

F6 Highest unprotected location + 1 

F7 Lowest unprotected location - 1 

F8 Address of internal interrupt processor 

F9 Logical unit number of standard input device 

FA Logical unit number of standard binary output device 

FB Logical unit number of standard print output device 

FC Logical unit number of output comment device 

FD Logical unit number of input comment device 

FE Address of the common interrupt handler 

FF Memory index (unprotected) - I register 



1-3 



\ 



--C 



INDEX 




INDEX 



absolute addressing 
absolute addressing mode 



5-49 



r 



one-word 




5-7 


one-word indirect 




5-8 


two-word 


5-8 


, 5-52 


two-word indirect 




5-9 


absolutized program 


11-10, 


11-12 


absolutizing addresses 




11-17 


absolutizing programs 




14-5 


adder 


2-6 


, 5-35 


address expressions 




5-5 


address field 




3-3 


addressing modes 


5-2 


, 5-13 


allocatable core 






11-1, 11-38, 


11-43, 


11-47 


alphanumeric characters 




6-7 


arithmetic 




2-1 


assembler errors 




9-13 


assembler format 




3-2 


assembling a program 




9-2 


automatic restart 




1-3 


background 8-1, 8 


-4, 9-1 


, H-1 


basic assembler 




6-1 


breakpoint package 




9-17 


buffer data channel 




12-66 


card reader 




12-23 


characteristics of 1700 




1-1 


checksum 




12-9 


checkword, disk 




12-38 


CKASSM program 




8-61 



comment field 


3-5 


common block 6-12, 


9-6, 11-15 


communications region 


11-1 


completion address 


8-8, 8-16 


conditional assembly 


6-15, 6-18 


configuration 


1-10 


console 


1-11 


constant addressing mode 


5-3, 5-49 


continuator, driver 


13-3 


control statements 




job processor 


9-2, 9-7 


breakpoint 


9-18 


recovery 


9-24 


conversion 


5-45 


core request 


8-55 


core size 


1-1, 1-6 


cylinder 


12-41 


data block 6-12 


, 6-14, 9-5 


debugging 


9-13 


delta 


5-1 


device assignment 


9-7, 9-17 


device failure 


9-15 



direct access channel (1705) 

1-3, 1-6, 12-36 



disk 

dispatcher 

drivers 

drum 

entering memory 



7-12 

11-3, 13-9, 13-13 

13-5, 13-9 

12-48 
1-12 



entry points 
error bit in Q 



INDEX (CONT) 
6-2 
8-16, 8-17, 8-19 



error checking, peripherals 12-63 

also see error bits on each peripheral 



error section, driver 

executing a program 

execution times 
shift class 
storage reference class 



13-4 
9-7 

5-32 
5-32 



exits 

EXIT request 

externals 



5-7, 11-3, 11-30, 11-38 

8-7 



6-2, 9-5, 11-14, 11-46, 11-49 

floating point numbers 2-7 

flow of program 11-11 

foreground 8-1, 8-4, 11-1 

FREAD request 8-8 

function codes 

see specific peripheral 

FWRITE request 8-8 

GTFILE request 8-47, 14-3 

hexadecimal numbers 2-1 

idle loop 11-3 

indexing 3-4, 5-13, 5-15, 5-50 

INDIR request 8-59, 8-61 

indirect addressing 5-53 

initiator, driver 13-1 

instruction classes 5-1 

inter register instructions 5-34 

input/output 1-6, 5-44, 7-1 

buffered 7-11, 12-36, 12-48, 12-66 
functions 7-5, 7-12 



input/output 
interrupts 
reply or reject 
requests 

priorities 

rejects 
status 
unbuffered 

integer numbers 



7-10, 13-1 

7-4 

11-35 

11-35 

11-37 

7-9, 7-16 

7-1 

2-4 



interrupt 

handler, common 

11-3, 13-3, 13-9, 13-12 



line processor 

mode programming 

stack 

system 

1-3, 5-43, 7-10, 11- 

job processor 

jump 

LIBEDT 

libraries 

listing 

load-and-go 

loader blocks 

loader errors 

LOADER request 

loading a program 

9-6, 9- 

location field 

logical operations 5- 

logical units 

low-speed I/O package 

M 

macro assembler 



13-3, 13-7 
13-1 
11-3 

•29, 13-1, 13-7 

9-1 

5-22 

14-1 

11-1, 11-12 

3-5, 3-7 

9-3 

11-6 

9-17 

8-54, 8-55 

■16, 14-2, 14-7 
3-2 

-21, 5-36, 6-16 

8-19 

7-3 

5-1 

6-1 





INDEX (CONT) 








macros 


6-16, 6-19 


priorities 








system macros 


6-19 


mass memory programs 




11-47 


magnetic tape 
1731 


12-57 


schedule requests 
space 


11-38, 


11-34 
11-43 


1732 


12-66 


program library 11 


-1, 11- 


■12 


, 14-3 


manual interrupt 


9-1 


protect bit 






1-2 


mask register 


1-3 


protect system 


1-2, 5- 


•29 


, 5-42 


masks 


6-5 


protected core 






11-1 


mass memory program 


coding 11-42 


pseudo-ops 






6-1 


mass memory program 


replacement 


READ request 






8-8 




14-1 


real numbers 






2-7 


mass storage address in 


g 8-15, 8-50 


record formats 






8-10 


mass storage files 


8-47, 14-5 


reentrant coding 






11-24 


mass storage operating 


system 8-1, 8-4 


registers 






1-7 


memory 


1-1 


register reference instructions 




5-40 



memory parity 5-29 

MONI 8-2, 8-4 

object program 11-4 

opcode field 3-3 

options for assembly (OPT card) 

6-20, 9-3 

2-7, 5-24, 5-28 

8-11, 12-6 

7-5, 8-11, 12-1 

1-2 

8-44 

1-3 

12-29 



rejects 

input/output requests 11-35, 11-37 
schedule requests 7-4 



release request 



11-40, 11-46 



relative addressing 

5-50, 11-14, 11-17, 11-19 



overflow 

paper tape punch 

paper tape reader 

parity bit 

physical device tables 

power failure 

printer 



priorities 11-3, 11-24, 8-28, 8-30 

hardware 13-10 

I/O requests 

11-35, 11-38, 8-9, 8-16 



relative addressing mode 




one-word 


5-10, 5-52 


one-word indirect 


5-12 


two-word 


5-12 


two-word indirect 


5-13 


requests 


8-1, 11-32 


REQXT 


8-2, 8-4 


runanywhere coding 


11-12 


buffer addresses 


11-17 


externals 


11-12 



schedule request 

11-32, 11-44, 8-8, 8-29, 8-36 



INDEX (CONT) 



scheduler stack 

sector 

shift instructions 

short read 

skip instructions 

source program 

space request 

STATUS request 



11-3 

12-37 

5-31, 5-51 

8-17, 8-47 

5-26, 5-51 

11-4 

11-39, 11-46 

8-42 
8-44 



status responses 

also see specific peripheral 

storage reference addressing mode 5-18 

storage reference instructions 5-18 

storage reservation 6-10 

subroutine parameters 



swapping core 
sweeping memory 
system initializer 
system library 
system recovery package 
tape 



5-37, 11-29, 11-32 
11-40 
1-13 
14-3, 14-6 
11-1, 11-12, 11-42 
9-17 



see magnetic or paper 



teletypewriter 
1711/1712 
1713 




8-10 
12-11 
12-17 


thread word 


8-19, 


8-28, 11-36 


timer request 




8-40, 11-34 


track 




12-37 


transfer address 




6-2 


transferring records 




14-7 


traps for interrupts 


1-4 


, 13-2, 13-7 



unprotected core 
utility assembler 
utility system 
Utopia 

variable fields 
volatile storage 
word size 
WRITE request 



11-1 

6-1 

8-1, 8-4, 8-5 

14-9 

6-9 

11-26, 11-28, 11-30 

1-1, 1-2 



CONTROL DATA 



ITIiirii 



#iMI»lt'l 



